FAQ
Models and parameters
Section titled “Models and parameters”How do I find available models?
Section titled “How do I find available models?”Use GET /v1/models with your API key. The public model directory provides model pages and current prices. See Available Models for classification and parameter-schema APIs.
Are inputs and duration limits the same for every model?
Section titled “Are inputs and duration limits the same for every model?”No. Inspect the exact model’s current schema. Do not infer reference video, audio, duration, or resolution support from another model in the same family.
What does a variant suffix mean?
Section titled “What does a variant suffix mean?”Variants such as global, economy, and prime are distinct model IDs. Compare their current parameter support, availability, and pricing rather than assuming a guaranteed speed or quality difference.
Billing
Section titled “Billing”When is my balance charged?
Section titled “When is my balance charged?”An accepted task reserves balance. The final charge is settled according to the applicable billing rule and confirmed usage. See Pricing & Billing.
What if generation fails?
Section titled “What if generation fails?”A confirmed task failure triggers failure settlement. A network timeout or unknown task is not a confirmed failure and may retain its reservation while being reconciled.
Are duplicate submissions charged only once?
Section titled “Are duplicate submissions charged only once?”No such guarantee is provided. Separate accepted submissions can create separate billable tasks. Save the returned task ID and poll that task instead of submitting again.
Results
Section titled “Results”How long does generation take?
Section titled “How long does generation take?”Time varies by model, request, and queue conditions. Use the task status rather than assuming a fixed completion deadline.
How long is the result URL valid?
Section titled “How long is the result URL valid?”Do not assume permanent availability or a fixed retention window. Download completed results promptly and store them in your own storage. Check the actual file’s format rather than assuming a particular codec for every model.
Can I cancel a task by closing my browser?
Section titled “Can I cancel a task by closing my browser?”No. Disconnecting or stopping your polling loop does not cancel an accepted task. The workflow documented here does not provide a cancellation operation.
How do I receive completion notifications?
Section titled “How do I receive completion notifications?”Use the polling endpoint in this workflow. This guide does not define a completion callback contract.
Account and support
Section titled “Account and support”How do I add funds?
Section titled “How do I add funds?”Open Wallet in your dashboard and use an available payment method. Available methods depend on the site’s configuration.
How do I manage API keys?
Section titled “How do I manage API keys?”Use the API key management page to edit supported settings, disable a key, or create a replacement. For rotation, update your application to the replacement key before revoking the old key. See API Keys.
What should I include in a support request?
Section titled “What should I include in a support request?”Include the task ID, model ID, approximate request time, HTTP status, and redacted error response. Do not include the API key itself. Contact support through the dashboard or the project’s GitHub repository.