API docsAPI reference

Seedance 2.5 · Cancel a task

POST /generations/:id/cancel asks the provider to stop a running task. Once the provider confirms, the task ends as failed with error "Canceled by user" and its credits are refunded. Supported on fal (while still queued) and Replicate; other providers, or tasks already finished, answer 409 not_cancelable.

POST/api/v1/generations/{id}/cancelBearer API key

seedance-2.5Video · ByteDanceModel details & pricing

Endpoints for this model

POST/generationsCreate a generation GET/generations/{id}Get the result POST/generations/{id}/cancelCancel a task POST/quoteQuote GET/models/{slug}Get one model

Parameter scope

Select a provider to see its effective parameter limits. Automatic routing chooses a provider that supports your input. Examples include defaults and required inputs; replace example media URLs with accessible files.

Request

cURL

curl -X POST 'https://01router.com/api/v1/generations/gen_example/cancel' \
  -H "Authorization: Bearer $API_KEY"

Input parameters

Query / path parameters

id string · pathRequired: Generation ID returned by the create request.

Response example

200 · application/json

{
  "id": "gen_example",
  "object": "generation",
  "model": "seedance-2.5",
  "type": "video",
  "provider": "fal",
  "status": "failed",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "outputs": [],
  "error": "Canceled by user",
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": "2026-10-25T08:01:00.000Z"
}

Responses are illustrative. IDs, usage, prices and results depend on the actual request.

Response fields

id string: Generation ID returned by the create request.
object "generation": generation
model string: Model slug from the catalog. Project keys may use a project-specific model slug.
type video | image | audio | chat
provider string: Optional provider slug. Omit for automatic routing; project settings may pin the provider.
status string: queued / processing / succeeded / failed. Stop polling on succeeded or failed.
input object: Model-specific input object. See the selected model reference for required fields, defaults and limits.
outputs string[]: Result file URLs. Empty until available; download promptly because URLs may expire.
error string | null: Error message on failure; null otherwise.
credits number: Credits charged for this generation; zero after a refund.
price_usd number: Price of this generation in USD; zero after a refund.
created_at string: Creation time in ISO 8601 format.
completed_at string | null: Completion time in ISO 8601 format, or null while running.

Use with AI

Give your coding assistant the documentation index or the full API reference, including live model parameters.

llms.txt llms-full.txt This page as Markdown