When to use it
The standard /v1/videos and /v1/images/generations endpoints cover common calls. Use /ark for newly released Volcano parameters, Seedance-specific controls, or native Seedream fields.
Path mapping: /ark replaces Volcano /api
The native Volcano Ark URL uses /api after the host. When calling through ZeroFA, replace that /api segment with /ark and keep the remaining /v3/contents/... path unchanged. Direct clients should use /ark/v3/....
Volcano native https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks
ZeroFA recommended https://zerofa.ai/ark/v3/contents/generations/tasksConnect through new-api
Create or edit the new-api channel used for Volcano video, set its custom API address (Base URL) to the ZeroFA /ark root, enter a ZeroFA API Key, and configure the Seedance models you use. new-api and ZeroFA handle the remaining routing automatically.
Open the complete new-api Volcano video setup guide →
# Upstream settings in the new-api channel
API address / Base URL: https://zerofa.ai/ark
API Key: sk-zerofa-xxx
Model: your-seedance-model-idTwo-step native Volcano flow
POST /ark/v3/contents/generations/tasksNative Volcano bodyRequiredGET /ark/v3/contents/generations/tasks/:idid = Volcano task idRequiredUse the official Volcano schema
/ark is a native passthrough endpoint and does not redefine Volcano content items, roles, model parameters, or asset limits. When a model has a default bitrate and the request omits bitrate_mode, that default is added; all other fields retain native semantics. Use the latest official Volcano documentation for request bodies and model capabilities.
Billing model
Request and response bodies
Use the examples below to verify the request and response structures. To send a request, select Debug at the top of the page.
# Native Volcano body: content and advanced flags pass through unchanged
# Path rule: replace the native Volcano /api segment with /ark
curl https://zerofa.ai/ark/v3/contents/generations/tasks \
-H "Authorization: Bearer sk-zerofa-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "your-seedance-model-id",
"content": [
{ "type": "text",
"text": "A shiba inu running through the snow --ratio 16:9 --duration 5 --resolution 720p" },
{ "type": "image_url",
"image_url": { "url": "https://.../dog.png" },
"role": "first_frame" }
]
}'
# Native Volcano response:{"id":"cgt-..."}curl https://zerofa.ai/ark/v3/contents/generations/tasks/cgt-xxx \
-H "Authorization: Bearer sk-zerofa-xxx"
# Native Volcano response passed through unchanged
# {"id":"cgt-...","status":"succeeded",
# "content":{"video_url":"https://...volces.com/....mp4"},
# "usage":{"completion_tokens":108900,...},
# "seed":83017,"resolution":"720p","ratio":"16:9", ...}