ByteDance Jimeng

Ownership and gateway boundary

Jimeng developer capabilities are documented through Volcengine visual services for image and video generation. They are separate from Doubao text models, so model or req_key values, endpoints, and job protocols are not interchangeable. This page declares only the adapted /v1/videos; it does not expose every capability in the Volcengine visual catalog.

Direct access and authentication

Official examples POST to https://visual.volcengineapi.com with Volcengine request signing; the current guide uses Region cn-north-1 and Service cv. This gateway uses its own base URL and Bearer token. A Volcengine access key belongs in direct or server-side channel configuration and must never be exposed to a browser.

Asynchronous jobs and identifiers

Generation commonly separates submit and query. request_id traces a request, while task_id identifies the job for retrieval. Persist both together with model or req_key, creation time, and redacted parameters. States can include in_queue, generating, done, not_found, and expired, so acceptance or HTTP success is not media success.

Temporary URLs, errors, and resource control

The cited Video 3.0 720P guide says its video_url is valid for one hour and tasks can later disappear; check each other API separately. Stream successful output into controlled storage immediately. Poll with bounded backoff, a total deadline, and a concurrency cap. Check the business code before parsing data, retain request_id, and prevent infinite retries and duplicate billing.

Rights, moderation, and cost

Bound asset type, size, and fetch origin and verify rights for people, trademarks, music, and references. Follow official AIGC-labeling and moderation requirements. Evaluate identity, motion, text, and moderation pass rate on real assets; model, dimensions, duration, quota, and cost remain function-page specific.