1. IMA-Pro 视频
Zcheap AI
  • Images
    • 查询图片任务状态与结果
      GET
  • IMA-Pro 视频
    • 创建异步视频任务
      POST
  • Asset
    • 创建素材分组
      POST
    • 查询素材分组列表
      POST
    • 查询单个素材分组
      POST
    • 更新素材分组
      POST
    • 上传素材（创建素材）
      POST
    • 查询素材列表
      POST
    • 查询单个素材
      POST
    • 更新素材名称
      POST
    • 查询素材配额信息
      POST
  • Midjourney
    • MJ 融图（Blend）
      POST
  • 生成图片
    POST
  • MJ 提交绘图任务
    POST
  • 查询任务状态与结果
    GET
  • MJ 变换操作（放大/变体/扩图/延展/重绘/重塑等）
    POST
  • 查询 MJ 任务状态
    GET
  • MJ 图片代理（首图）
    GET
  • Schemas
    • AssetGroupCreateRequest
    • AssetGroupListRequest
    • AssetCreateRequest
    • AssetListRequest
    • AssetItem
    • AssetGroupItem
    • AssetIdResponse
    • AssetGroupResponse
    • AssetGetResponse
    • AssetGroupListResponse
    • AssetListResponse
    • AssetQuotaResponse
    • MjSubmitResponse
    • ImaProVideoCreateRequest
    • ImaImageGenerationRequest
    • ErrorResponse
    • ImaImageGenerationRequestGemini3Pro
    • ImaImageGenerationRequestGemini31Flash
    • ImaImageGenerationResponse
    • ImaImageCreateTaskResponse
    • ImaImageTaskFetchResponse
    • ImaProCreateResponse
    • ImaProQueryResponse
    • TaskErrorResponse
    • MjTaskFetchResponse
  1. IMA-Pro 视频

创建异步视频任务

POST
/v1/videos
使用以下模型之一提交任务：
ima-pro
ima-pro-fast
seedance-2.0
seedance-2.0-fast
seedance-2.0-cn
seedance-2.0-fast-cn
鉴权：请求头必须包含 Authorization: Bearer sk-...。
端点约束：/v1/videos 为视频任务端点，不支持图片模型（例如 gemini-3-pro-image-preview、gemini-3.1-flash-image-preview）。
常用字段：
文本：prompt
图片：images（支持多图）
参考视频：metadata.reference_video_urls
参考音频：metadata.reference_audio_urls
音频开关：metadata.audio（版权风险场景建议先置为 false，即无背景音乐）
组合逻辑（对齐 New API 当前行为）：
文本（prompt 必填）
文本 + 图片（prompt 可选）
文本 + 视频（prompt 可选）
文本 + 图片 + 音频（prompt 可选）
文本 + 图片 + 视频（prompt 可选）
文本 + 视频 + 音频（prompt 可选）
文本 + 图片 + 视频 + 音频（prompt 可选）
图片角色映射（重要）：
默认模式（role_mode=reference）：图片统一映射为 reference_image
帧模式（role_mode=frame）：单图映射 first_frame，双图映射 first_frame + last_frame
帧模式不能与 reference_video_urls/reference_audio_urls 同时使用
人物素材合规说明：
使用自有虚拟人物或真人素材时，仅限素人，不支持明星人物。
平台会对上传素材进行审核，以规避可能的法律风险。
已支持通过 /v1/assets/create 上传人物素材（创建素材）并进入审核流程。
建议流程：先调用 /v1/assets/create 上传并沉淀素材，再在 /v1/videos 请求中引用已审核素材。
上传后可调用 /v1/assets/get 轮询素材状态，一般 10s 内即可获取结果。
文档示例支持点击复制；复制后的请求体可直接交给 AI 自动识别并生成最终接入代码。
如需批量接入素材，请优先走素材库接口而非临时直链。
下方示例是请求体，不是返回体。

Request

Authorization
or
Header Params

Body Params application/jsonRequired

Examples
{
    "model": "ima-pro-fast",
    "prompt": "清晨城市延时摄影，暖色调，电影感。",
    "duration": 5
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/v1/videos' \
--header 'Authorization: Bearer sk-xxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
    "model": "ima-pro-fast",
    "prompt": "清晨城市延时摄影，暖色调，电影感。",
    "duration": 5
}'

Responses

🟢200OK
application/json
任务提交成功
Bodyapplication/json

Examples
{
    "id": "task_202603131631387ETKUBM91MTD72X9",
    "task_id": "task_202603131631387ETKUBM91MTD72X9",
    "object": "video",
    "model": "ima-pro",
    "status": "",
    "progress": 0,
    "created_at": 1773395498
}
🟠400Bad Request
🟠401Unauthorized
🔴500Server Error
Modified at 2026-04-03 13:45:37
Previous
查询图片任务状态与结果
Next
创建素材分组
Built with