OpenAPI - 提交任务接口文档

概述

接口地址: POST /api/openapi/submit

提交异步 AI 生成任务（图片生成、视频生成）。

认证方式

Authorization: Bearer <your-api-key>

请求参数

{
  model: string;           // 必填 - 模型名称
  params: TaskParams;      // 必填 - 模型参数
  callback_url?: string;   // 可选 - 任务完成后的回调通知地址
  metadata?: object;       // 可选 - 自定义元数据（查询结果时原样返回）
}

响应结果

{
  task_id: string;              // 任务ID，用于查询结果
  status: "pending";            // 初始状态
  estimated_credits?: number;   // 预估消耗积分
  created_at: string;           // 创建时间（ISO 格式）
}

模型与参数说明

图片生成模型

seedream_v4

Seedream V4 图片生成。

seedream_v4_5

Seedream V4.5 图片生成（更高质量）。

nano_banana

Nano Banana 图片生成。

nano_banana_pro

Nano Banana Pro 图片生成。

gpt_4o

GPT-4o 图片生成。

视频生成模型

sora2

Sora2 视频生成。

sora2_pro

Sora2 Pro 视频生成（更高质量）。

veo3_1

Veo3 视频生成。

veo3_1_fast

Veo3 Fast 视频生成（更快速度）。

快速参考表

图片模型

视频模型

请求示例

图片生成

{
  "model": "seedream_v4",
  "params": {
    "prompt": "海边美丽的日落",
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "output_n": "2"
  }
}

视频生成

{
  "model": "sora2",
  "params": {
    "prompt": "一只猫在花园里散步",
    "aspect_ratio": "16:9",
    "video_length": "10"
  }
}

带参考图片

{
  "model": "veo3_1",
  "params": {
    "prompt": "让这张图片动起来",
    "image_url": "https://example.com/reference.jpg",
    "aspect_ratio": "16:9"
  }
}

错误码说明