img_uuid, and resolve the result by polling or HTTPS callback.AI Video Effects API for Automated Creative Workflows
Access AI Video Effects through the independent GoEnhance API. List available templates, submit an authorized reference image with an effect ID, save the returned
Create an API Key
AI Video Effects API Capabilities
Discover Available Effects
Call GET /api/v1/videoeffect/list with bearer authentication to retrieve current effect IDs, labels, and preview URLs instead of hard-coding a stale catalog.
Generate and Track a Task
POST a public reference_img and valid effect_id to /api/v1/videoeffect/generate, then store the returned img_uuid for status checks.
Validate credentials, media access, template identity, and callback configuration before creating a task.
AI Video Effects API Request Essentials
Bearer Authentication
Send your GoEnhance API key in the <code>Authorization</code> header and keep it on the server, never in client-side code.
Template Discovery
Use <code>GET /api/v1/videoeffect/list</code> to retrieve the current catalog before showing effect choices in your product.
Reference Image
Provide a publicly accessible HTTPS image URL in <code>reference_img</code> and use only media you own or are authorized to process.
Effect Identifier
Pass the selected template's exact <code>effect_id</code>; validate it against the current list response instead of guessing identifiers.
Optional Callback
Provide <code>custom_callback_url</code> when you want status notifications sent to a public HTTPS endpoint.
Asynchronous Task ID
Persist <code>data.img_uuid</code> from a successful submit response and associate it with your internal request record.
Use live template data and documentation rather than an invented or stale universal price.
AI Video Effects API Pricing
Pricing Varies by Effect
AI video effects API pricing depends on the selected template and the current GoEnhance catalog. Do not assume one fixed rate for every effect.
Check the Live Catalog
Use the template-list API and current GoEnhance documentation as the source of truth for the effect you plan to run.
Budget Before Submission
Resolve the chosen <code>effect_id</code> and its current billing details before queuing production batches, because catalog terms can change.
Integrate AI Video Effects in Three Steps
1
1. Discover and Validate
Fetch the effect list, choose an exact
effect_id, and validate that your HTTPS reference image is reachable and authorized for processing. 2
2. Submit and Persist
POST
reference_img, effect_id, and an optional callback URL, then save data.img_uuid from the response. 3
3. Resolve the Terminal Result
Poll
GET /api/v1/jobs/detail?img_uuid=... or process callback bodies idempotently until the task reaches success or failed.Build repeatable effect workflows around content you own or have permission to transform.
AI Video Effects API Use Cases
Creator Tools
Let users select approved effects and turn authorized still images into short dynamic assets from your application.
Campaign Variants
Queue effect variations for marketing concepts while keeping source ownership, moderation, and approval in your own workflow.
UGC Pipelines
Connect uploads, effect selection, asynchronous processing, and result delivery in a traceable backend pipeline.
Entertainment Experiences
Build opt-in novelty and themed animation features with clear consent and content-policy checks.
Batch Creative Operations
Persist task IDs and process terminal results independently so batches can recover from timeouts without duplicate submissions.
Media Automation
Route completed videos into storage, review, moderation, and publishing systems only after validating the terminal response.
Answers about endpoints, pricing, inputs, asynchronous delivery, and production safeguards.