通义千问
PixVerse 文生视频(异步):提示词放在 messages 中;size、duration、audio、watermark、seed 放在 extra.parameters(亦可平铺在 extra 根级,由网关合并)。模型标识由服务端配置(一般为 pixverse/pixverse-c1-t2v)。任务创建后通过 GET /v1/video-task/{job_id} 轮询;分辨率与时长等细则见同页「Markdown」页签。
字段规则(与本站网关校验一致)
| 字段 | 类型 | 说明 |
|---|---|---|
messages → prompt |
string | 对应 input.prompt,最长 5000 字符(超出截断)。 |
size |
string | 格式 宽*高;须为下方列表之一,否则回退 640*360。 |
duration |
int | 时长(秒),默认 5;网关限制在 1~15。 |
audio |
bool | 是否有声视频,默认 false。 |
watermark |
bool | 是否加水印,默认 false。 |
seed |
int | 可选,范围 0~2147483647;非法则省略。 |
size 允许取值(与本站网关允许列表一致):
1024*1024 1024*448 1024*576 1024*688 1024*768 1080*1920 1108*832 1184*1776 1200*800 1248*1664 1280*560 1280*720 1440*1440 1664*1248 1776*1184 1920*1080 1920*832 360*640 432*640 480*640 576*1024 640*288 640*360 640*432 640*480 640*640 688*1024 720*1280 768*1024 800*1200 832*1108 960*960
完整档位细则见「Markdown」页签;size 枚举列表由本站维护。
左侧为章节切换,右侧为对应内容。
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization |
string | 是 | Bearer 令牌,格式为 Bearer sk-xxxxxxxx(注册时生成的 API 密钥,以 sk- 开头)。浏览器对话页也可使用登录 Cookie AI_LOGIN。兼容 OpenAI SDK:将完整 sk-... 作为 api_key 传入即可。 |
对接 HTTP 接口请使用上表 Authorization: Bearer {应用ID}-{应用密钥};兼容 OpenAI SDK(将 {应用ID}-{应用密钥} 作为 api_key)。站内网页另有 Cookie 兼容方式,不在此列出。
非流式与流式使用同一请求体结构;流式请使用 …/v1/chat/stream 路径。
多轮与上下文:接口按当次请求里的 messages 处理对话,不会替你「记住」上一轮正文。续聊须由客户端在 body 中组装完整历史(含此前的 user / assistant 等)。
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
model_id |
int | 是 | 模型主键;本页文档对应 `model_id=16`。 |
messages |
array | 是 | 消息对象数组(见 messages[])。至少一条;多轮时须在数组内按顺序包含完整历史(user/assistant/system 等)。按本次列表处理对话,不自动补全缺省轮次。 |
temperature |
number | 否 | 采样温度,默认 0.7;是否生效取决于具体模型。 |
max_tokens |
int 或 null | 否 | 生成长度上限(token);null 表示使用默认。 |
stream |
bool | 否 | 请求体字段,默认 false。**是否流式由 URL 决定**:流式请 POST `/v1/chat/stream`;`/v1/chat` 为非流式。勿仅靠本字段切换 SSE。 |
attachments |
array | 否 | 附件数组,默认 [](见 attachments[])。服务端会把附件整理为模型可识别的上下文(如追加 system 说明 URL 列表)。 |
extra |
object | 否 | 任意 JSON 对象,默认 {}。模型专有参数放于此(如数字人 image_url/audio_url/parameters;文生图/视频类 prompt、尺寸等)。服务端可能合并内部保留字段;请勿使用以下划线 `_` 开头的键名作为业务自定义字段。 |
数组顺序即对话顺序;多轮时把历史轮次一并列入本数组即可。
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
role |
string | 是 | 角色:如 user、assistant、system 等,与 OpenAI Chat Completions 约定一致。 |
content |
string | 是 | 该轮文本内容。多轮时 assistant 一般为上一轮模型输出,由客户端保存后在后续请求的 messages 中写回。 |
images |
array 或 null | 否 | 历史消息中的多模态图片结构,会话回放用;元素为对象,字段因模型而异。 |
audios |
array 或 null | 否 | 历史消息中的音频结构,会话回放用。 |
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
url |
string | 是 | 附件可访问 URL(须能被服务端拉取)。 |
filename |
string 或 null | 否 | 原始文件名,便于展示或日志。 |
mime |
string 或 null | 否 | MIME 类型,如 image/png。 |
extra |
object | 否 | 附件级扩展信息,默认 {}。 |
提示词在 `messages`;视频参数在 `extra.parameters`(亦可与根级 `extra` 扁平字段由网关合并)。分辨率枚举与时长规则见同页「Markdown」模型专属章节。
下列说明与下方「调用示例」JSON 对齐,由本站配置维护。
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
model_id |
int | 是 | 须为 `16`。DashScope `model`(如 pixverse/pixverse-c1-t2v)由服务端配置,请求体不传。 |
messages[].content |
string | 是 | 文生视频提示词,对应 `input.prompt`(最长约 5000 字,网关截断)。 |
extra.parameters.size |
string | 否 | 输出分辨率 `宽*高`;须为允许列表之一,非法则回退 `640*360`。 |
extra.parameters.duration |
int | 否 | 时长(秒),默认 5;网关限制在 1~15。 |
extra.parameters.watermark |
bool | 否 | 是否加水印;默认 false。 |