Sozdai LogoDocs
接口/Media

提交媒体生成任务

提交异步媒体生成（如文生图、文生视频、AI 音乐）任务。提交后系统将立即返回任务 ID 并进行额度冻结，实际处理在后台异步排队。

POSThttps://api.sozdai.ai/v1/media/generations

#认证

所有请求在 Authorization 请求头携带你的密钥。

http
Authorization: Bearer sk-corr-...

#请求参数

参数类型是否必填说明
modelstring是调用的媒体模型 ID，如 gpt-image-2 或 kling-video
promptstring是生成媒体内容的提示词描述
...any否根据不同模型，可能支持的其它高级生成参数（详见各模型文档页）

#请求示例

bash
curl https://api.sozdai.ai/v1/media/generations \
  -H "Authorization: Bearer $CORRY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a futuristic city skyline in vaporwave style"
  }'

#响应示例

返回刚创建的媒体任务状态与 ID。

json
{
  "id": "task_abc123",
  "status": "pending"
}

轮询结果说明

获取任务 ID 后，你需要调用 查询媒体任务接口 来轮询最终生成的资源地址。当 status 变为 succeeded 时，result.urls 即为永久可访问的文件链接。