创建异步生成任务

创建异步生成任务（支持视频、图像和音频生成）。支持 application/json 和 multipart/form-data 两种请求内容类型。

认证

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。格式：Authorization: Bearer sk-xxxxxx

In: header

请求体

application/json

model*string

用于选择模型配置和上游渠道映射的平台模型名称。

prompt?string

主要的生成或编辑指令。

input?string

当 prompt 为空时用作平台兜底的文本输入。

action?string

当端点支持多种操作时要执行的模型操作。

negative_prompt?string

描述生成结果中应避免的内容或特征。

image?string

单张参考图片的 URL 或 base64 数据 URI。

image_url?string

Alias of image; compatible with provider-style form uploads (applies to: video, image).

images?array<string>

参考图片 URL 或 base64 数据 URI 的列表。

image_urls?array<string>

Alias of images; compatible with Fal-style image edit inputs (applies to: video, image).

input_reference?string

支持基于参考生成的模型用作输入的参考标识符或 URI。

audio_url?string

输入音频 URL。

video_url?string

输入视频 URL。

size?string

平台规范 WIDTHxHEIGHT 格式的输出尺寸，例如 1024x1024 或 1280x720。

aspect_ratio?string

采用平台规范冒号表示法的输出宽高比，例如 16:9、9:16 或 1:1。

ratio?string

Provider-specific ratio field (applies to: video, image).

resolution?string

使用平台规范小写值的输出分辨率档位。

width?integer

支持显式尺寸时的输出宽度（像素）。

height?integer

支持显式尺寸时的输出高度（像素）。

duration?integer

请求的输出时长（秒）。

seconds?string

OpenAI-compatible video duration field (applies to: video).

n?integer

要生成的输出数量。

seed?integer

上游服务商支持时，用于复现或稳定生成结果的随机种子。

quality?string

输出质量等级。

style?string

请求的生成风格。

response_format?string

平台响应表示形式。url 返回结果 URL，b64_json 请求 base64 编码的结果。

output_format?string

生成资产的文件格式。请使用 jpeg 而不是 jpg。

voice?string

用于音频生成的声音标识符。

speed?number

音频生成或播放速度倍数。

title?string

与生成媒体关联的标题。

tags?string

与生成请求关联的标签或风格标签。

lyrics?string

用于音乐生成的歌词。

callback_url?string

Callback URL when supported by the upstream provider.

metadata?object

不属于统一 API 的服务商特定参数。统一的顶层字段优先，且不允许 callback 或 webhook 字段。

cURLJavaScriptGoPythonJavaC#

curl -X POST "https://cn-api.tokiway.com/generation/tasks" \  -H "Content-Type: application/json" \  -d '{    "model": "wanx2.1-t2i-turbo"  }'

200

{
  "code": "success",
  "message": "string",
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": "queued",
    "media_type": "image",
    "model": "gpt-image-2",
    "created_at": 1780000000
  }
}

响应体

200

application/json

创建异步生成任务 · 异步生成任务

创建异步生成任务

认证

请求体

响应体

200