使用原生登录 access_token 直接扣减本人钱包创建标准异步视频任务。断线后通过 /pg/requests/by-intent 获取 task_status_url(/pg/videos/{task_id})继续轮询,不得重复 POST。
POST
/pg/videos身份验证
Authorizationstring必填使用登录取得的 native access_token(身份要求:登录 access_token),按路由校验本人归属与受信任浏览器 Origin;生成写入按钱包规则扣费,只读查询不重新预扣;不得使用推理 API Key(sk-…)或 PAT(nap_…)。
Authorization: Bearer $ONEASTER_ACCESS_TOKEN
参数
Idempotency-Keystringheader · 每次新发起的 /pg 生成提交建议由前端生成并持久化稳定的 1–100 位无空格可打印 ASCII 标识(推荐 UUID),断线重试保持原标识与原请求字节。同账号跨所有 /pg POST 协议共用一个命名空间;省略时后端兼容生成并通过 X-OneAster-Intent-ID 返回,但若响应头丢失将无法按意图恢复。
请求正文 · application/json
modelstring必填目录中的视频模型调用 ID(model_name)
promptstring必填secondsstringsizestringJSON Schema
{
"type": "object",
"required": [
"model",
"prompt"
],
"properties": {
"model": {
"type": "string",
"description": "目录中的视频模型调用 ID(model_name)"
},
"prompt": {
"type": "string"
},
"seconds": {
"type": "string"
},
"size": {
"type": "string"
}
},
"additionalProperties": true
}请求正文 · multipart/form-data
详见完整规范。
JSON Schema
{
"type": "object",
"additionalProperties": true,
"description": "Model-specific native multipart fields and file references"
}