视频生成与任务查询 API 文档

https://qorastudio.cn/api/v1
Authorization: Bearer YOUR_QORA_API_KEY
Content-Type: application/json

curl 'https://qorastudio.cn/api/v1/balance' \
  -H 'Authorization: Bearer YOUR_QORA_API_KEY'

{
  "data": {
    "balance_credits": 712.5,
    "balance_cny": 71.25,
    "currency": "CNY",
    "credits_per_cny": 10,
    "updated_at": 1792324800000
  }
}

curl "https://qorastudio.cn/api/v1/tasks?source=api&page=1&page_size=100" -H "Authorization: Bearer YOUR_QORA_API_KEY"

curl 'https://qorastudio.cn/api/v1/video/models' \
  -H 'Authorization: Bearer YOUR_QORA_API_KEY'

{
  "data": [
    {
      "id": "qr-v021",
      "model": "seedance-mini",
      "name": "按条特惠",
      "available": true,
      "note": "至少1张参考图片；5、10、15秒同价。",
      "billing": "generation",
      "prices_credits": {
        "720p": 15
      },
      "resolutions": [
        "720p"
      ],
      "ratios": [
        "16:9",
        "9:16",
        "1:1",
        "4:3",
        "3:4"
      ],
      "durations": [
        5,
        10,
        15
      ],
      "duration_ranges": null,
      "modes": [
        "references"
      ],
      "references": {
        "images": 9,
        "videos": 0,
        "audio": 0,
        "min_images": 1,
        "min_audio": 0
      },
      "prompt_required": true,
      "duration_source": "duration",
      "prompt_limit": 15000
    }
  ],
  "currency": "credits",
  "credits_per_cny": 10
}

route_id: qr-v043
状态: 暂时不可用
价格: 480p：25积分/条（¥2.50/条）；720p：25积分/条（¥2.50/条）；1080p：25积分/条（¥2.50/条）
清晰度: 480p / 720p / 1080p
时长: 2 / 3 / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18 / 19 / 20 / 21 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 29 / 30秒
画面比例: 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16
task_mode: text / references / first_frame / first_last_frame
参考数量: 图片 0–10；视频 0–5；音频 0–5
提示词: 最多15000字符；必填非空描述

route_id: qr-v042
状态: 开放调用
价格: 720p：55积分/条（¥5.50/条）；1080p：70积分/条（¥7.00/条）
清晰度: 720p / 1080p
时长: 固定30秒
画面比例: 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9
task_mode: text / references
参考数量: 图片 0–10；视频 0–0；音频 0–0
提示词: 最多15000字符；必填非空描述

route_id: qr-v040
状态: 开放调用
价格: 30积分/条（¥3.00/条）
清晰度: 480p
时长: 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15秒
画面比例: 16:9 / 9:16 / 1:1 / 4:3 / 3:4
task_mode: text / references
参考数量: 图片 0–9；视频 0–3；音频 0–3
提示词: 最多15000字符；必填非空描述

route_id: qr-v035
状态: 开放调用
价格: 15积分/条（¥1.50/条）
清晰度: 720p
时长: 固定10秒
画面比例: 16:9 / 9:16 / 1:1 / 4:3 / 3:4
task_mode: text / references
参考数量: 图片 0–9；视频 0–0；音频 0–0
提示词: 最多15000字符；必填非空描述

route_id: qr-v036
状态: 开放调用
价格: 25积分/条（¥2.50/条）
清晰度: 720p
时长: 5 / 10 / 15秒
画面比例: 16:9 / 9:16
task_mode: text / references
参考数量: 图片 0–9；视频 0–0；音频 0–0
提示词: 最多15000字符；必填非空描述

route_id: qr-v037
状态: 开放调用
价格: 39积分/条（¥3.90/条）
清晰度: 720p
时长: 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15秒
画面比例: 16:9 / 9:16 / 1:1 / 4:3 / 3:4
task_mode: text / references
参考数量: 图片 0–9；视频 0–9；音频 0–9
提示词: 最多15000字符；必填非空描述

route_id: qr-v038
状态: 开放调用
价格: 480p：0.8积分/秒（¥0.08/秒）；720p：0.9积分/秒（¥0.09/秒）
清晰度: 480p / 720p
时长: 4–30秒整数
画面比例: 16:9 / 9:16
task_mode: text / references
参考数量: 图片 0–9；视频 0–1；音频 0–3
提示词: 最多15000字符；必填非空描述

route_id: qr-v007
状态: 开放调用
价格: 480p：3.5积分/秒（¥0.35/秒）
清晰度: 480p
时长: 4–30秒整数
画面比例: 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16
task_mode: text / first_frame / first_last_frame / references
参考数量: 图片 0–30；视频 0–10；音频 0–10
提示词: 最多15000字符；必填非空描述

route_id: qr-v012
状态: 开放调用
价格: 720p：4.5积分/秒（¥0.45/秒）
清晰度: 720p
时长: 4–30秒整数
画面比例: 16:9 / 9:16 / 4:3 / 3:4 / 1:1
task_mode: text / references
参考数量: 图片 0–30；视频 0–0；音频 0–10；参考音频总时长≤15秒；音频须配图
提示词: 最多10000字符；必填非空描述

route_id: qr-v018
状态: 开放调用
价格: 720p：2积分/秒（¥0.20/秒）
清晰度: 720p
时长: 4–15秒整数
画面比例: 9:16
task_mode: text / first_frame / first_last_frame / references
参考数量: 图片 0–9；视频 0–3；音频 0–3
提示词: 最多15000字符；必填非空描述

route_id: qr-v019
状态: 开放调用
价格: 720p：1积分/秒（¥0.10/秒）
清晰度: 720p
时长: 4–15秒整数
画面比例: 9:16
task_mode: references
参考数量: 图片 0–9；视频 0–3；音频 0–3
提示词: 最多15000字符；必填非空描述

route_id: qr-v020
状态: 开放调用
价格: 720p：1.5积分/秒（¥0.15/秒）
清晰度: 720p
时长: 4–15秒整数
画面比例: 9:16
task_mode: references
参考数量: 图片 0–9；视频 0–3；音频 0–3
提示词: 最多15000字符；必填非空描述

route_id: qr-v024
状态: 开放调用
价格: 480p：0.4积分/秒（¥0.04/秒）；768p：0.9积分/秒（¥0.09/秒）；1080p：1.3积分/秒（¥0.13/秒）
清晰度: 480p / 768p / 1080p
时长: 480p：1–15秒整数；768p：1–15秒整数；1080p：1–10秒整数
画面比例: 16:9 / 9:16 / 1:1
task_mode: references
参考数量: 图片 1–9；视频 0–0；音频 0–0
提示词: 最多8000字符；必填非空描述

route_id: qr-v025
状态: 开放调用
价格: 480p：0.7积分/秒（¥0.07/秒）；768p：0.8积分/秒（¥0.08/秒）
清晰度: 480p / 768p
时长: 480p：1–15秒整数；768p：1–15秒整数
画面比例: 16:9 / 9:16 / 1:1
task_mode: text
参考数量: 图片 0–0；视频 0–0；音频 0–0
提示词: 最多8000字符；必填非空描述

route_id: qr-v026
状态: 开放调用
价格: 480p：0.8积分/秒（¥0.08/秒）；768p：1积分/秒（¥0.10/秒）
清晰度: 480p / 768p
时长: 480p：1–15秒整数；768p：1–15秒整数
画面比例: 16:9 / 9:16 / 1:1
task_mode: first_last_frame
参考数量: 图片 2–2；视频 0–0；音频 0–0
提示词: 最多8000字符；必填非空描述

route_id: qr-v027
状态: 开放调用
价格: 480p：1积分/秒（¥0.10/秒）；768p：1.2积分/秒（¥0.12/秒）
清晰度: 480p / 768p
时长: 480p：1–15秒整数；768p：1–15秒整数
画面比例: 16:9 / 9:16 / 1:1
task_mode: references
参考数量: 图片 1–9；视频 0–0；音频 0–3
提示词: 最多8000字符；必填非空描述

route_id: qr-v028
状态: 开放调用
价格: 480p：1.1积分/秒（¥0.11/秒）；768p：1.2积分/秒（¥0.12/秒）；1080p：1.4积分/秒（¥0.14/秒）
清晰度: 480p / 768p / 1080p
时长: 480p：1–15秒整数；768p：1–15秒整数；1080p：1–15秒整数
画面比例: 16:9 / 9:16
task_mode: first_frame
参考数量: 图片 1–1；视频 0–0；音频 1–1
提示词: 最多8000字符；可传空字符串；duration用于音频驱动的生成时长

route_id: qr-v032
状态: 开放调用
价格: 480p：1.2积分/秒（¥0.12/秒）；768p：1.4积分/秒（¥0.14/秒）；1088p：1.4积分/秒（¥0.14/秒）；1440p：1.5积分/秒（¥0.15/秒）
清晰度: 480p / 768p / 1088p / 1440p
时长: 480p：1–15秒整数；768p：1–15秒整数；1088p：1–15秒整数；1440p：1–15秒整数
画面比例: 16:9 / 9:16
task_mode: references
参考数量: 图片 1–6；视频 0–0；音频 1–3
提示词: 最多8000字符；必填非空描述

{
  "action": "authorize",
  "source": "当前文件内容的SHA256小写十六进制",
  "size": 1852422,
  "type": "image/png"
}

{
  "action": "complete",
  "id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb"
}

// Node.js 18+：只直传图片，不创建视频，不扣生成积分。
// 设置 QORA_API_KEY、QORA_REFERENCE_FILE，保存为 qora-upload.mjs 后运行。
import fs from 'node:fs/promises';
import path from 'node:path';
import {createHash} from 'node:crypto';
const key=process.env.QORA_API_KEY,file=process.env.QORA_REFERENCE_FILE;
if(!key||!file)throw Error('请设置QORA_API_KEY和QORA_REFERENCE_FILE');
const bytes=await fs.readFile(file),type=({'.png':'image/png','.jpg':'image/jpeg','.jpeg':'image/jpeg','.webp':'image/webp'})[path.extname(file).toLowerCase()];
if(!type)throw Error('请使用PNG、JPG或WebP图片');
async function uploadReference(bytes,type,filename){
 async function control(body){
  for(let attempt=0;;attempt++){
   let r;
   try{r=await fetch('https://qorastudio.cn/api/v1/assets/direct',{method:'POST',redirect:'error',headers:{Authorization:'Bearer '+key,'Content-Type':'application/json'},body:JSON.stringify(body),signal:AbortSignal.timeout(120000)});}catch(error){if(attempt>=2)throw error;await new Promise(r=>setTimeout(r,1000*(attempt+1)));continue;}
   const d=await r.json();if(r.ok)return d;
   const retry=[408,429,500,502,503,504].includes(r.status)||r.status===409&&['upload_unconfirmed','upload_in_progress'].includes(d.error?.code);
   if(!retry||attempt>=2)throw Error(d.error?.message||'上传控制请求未完成');
   await new Promise(resolve=>setTimeout(resolve,Math.max(1,Math.min(30,Number(r.headers.get('Retry-After'))||2))*1000));
  }
 }
 const authorized=await control({action:'authorize',source:createHash('sha256').update(bytes).digest('hex'),size:bytes.length,type});
 let ready=authorized;
 if(authorized.status!=='ready'){
  const host=new URL(authorized.host);
  if(authorized.status!=='uploading'||authorized.upload_mode!=='post_form'||host.origin!=='https://qorastudio.oss-cn-hongkong.aliyuncs.com'||host.username||host.password||host.pathname!=='/'||host.search||host.hash||!authorized.fields)throw Error('直传授权响应异常');
  const form=new FormData();for(const [name,value]of Object.entries(authorized.fields))form.append(name,value);
  form.append('file',new Blob([bytes],{type}),path.basename(filename));
  // 文件正文只发到本站OSS；这里不能携带Qora Bearer密钥。
  try{const uploaded=await fetch(host,{method:'POST',redirect:'error',body:form,signal:AbortSignal.timeout(600000)});await uploaded.body?.cancel();}catch{}
  // 上传响应丢失也先确认同一id，避免重复发送整份文件。
  try{ready=await control({action:'complete',id:authorized.id});}catch(error){throw Error('素材编号 '+authorized.id+' 尚未确认，请保留编号并重试complete；'+error.message);}
 }
 if(ready.status!=='ready'||ready.id!==authorized.id||ready.expired||ready.expires_at!=null&&ready.expires_at<=Date.now())throw Error('素材尚未可用，不能提交生成');
 return ready;
}
const ready=await uploadReference(bytes,type,file);
console.log(JSON.stringify(ready,null,2));
// 后续references只使用ready.id；同账号同文件再次authorize会复用未过期素材。

# PowerShell
(Get-FileHash -LiteralPath .\reference.png -Algorithm SHA256).Hash.ToLower()

# macOS / Linux
shasum -a 256 reference.png

curl 'https://qorastudio.cn/api/v1/assets' \
  -H 'Authorization: Bearer YOUR_QORA_API_KEY' \
  -H 'Content-Type: image/png' \
  -H 'X-Qora-Source: FILE_SHA256' \
  --data-binary @reference.png

{
  "id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
  "type": "image/png"
}

{
  "route_id": "qr-v007",
  "prompt": "纸船缓缓漂过水面，镜头保持平稳。",
  "duration": 4,
  "resolution": "480p",
  "ratio": "16:9",
  "task_mode": "text"
}

{
  "route_id": "qr-v021",
  "prompt": "参考图中的小船缓缓驶过石桥，水面自然泛起涟漪。",
  "duration": 15,
  "resolution": "720p",
  "ratio": "16:9",
  "task_mode": "references",
  "references": [
    {
      "id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
      "role": "reference_image"
    }
  ]
}

{
  "route_id": "qr-v028",
  "prompt": "",
  "duration": 5,
  "resolution": "480p",
  "ratio": "16:9",
  "task_mode": "first_frame",
  "references": [
    {
      "id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
      "role": "first_frame"
    },
    {
      "id": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
      "role": "reference_audio"
    }
  ]
}

{
  "route_id": "qr-v007",
  "prompt": "人物参考@图1，动作参考@视频1，声音参考@音频1。人物面向镜头自然说话。",
  "duration": 4,
  "resolution": "480p",
  "ratio": "16:9",
  "task_mode": "references",
  "references": [
    {
      "id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
      "role": "reference_image"
    },
    {
      "id": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
      "role": "reference_video"
    },
    {
      "id": "dddddddd-dddd-4ddd-8ddd-dddddddddddd",
      "role": "reference_audio"
    }
  ]
}

{
  "route_id": "qr-v043",
  "prompt": "参考@视频1的动作节奏，镜头平稳推进。",
  "duration": 10,
  "resolution": "720p",
  "ratio": "16:9",
  "task_mode": "references",
  "references": [
    {
      "id": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
      "role": "reference_video"
    }
  ]
}

curl 'https://qorastudio.cn/api/v1/video/quotes' \
  -H 'Authorization: Bearer YOUR_QORA_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: your-order-001' \
  --data '{"route_id":"qr-v021","prompt":"参考图中的小船缓缓驶过石桥，水面自然泛起涟漪。","duration":15,"resolution":"720p","ratio":"16:9","task_mode":"references","references":[{"id":"bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb","role":"reference_image"}]}'

{
  "data": {
    "id": "aaaaaaaa-aaaa-5aaa-8aaa-aaaaaaaaaaaa",
    "model": "qr-v021",
    "status": "quoted",
    "progress": null,
    "price_credits": 15,
    "duration": 15,
    "resolution": "720p",
    "ratio": "16:9",
    "created_at": 1792324800000,
    "completed_at": null,
    "expires_at": null,
    "error": null,
    "download_url": null,
    "quote_ready": true,
    "quote_expires_at": 1792324860000
  }
}

curl 'https://qorastudio.cn/api/v1/video/generations' \
  -H 'Authorization: Bearer YOUR_QORA_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: your-order-001' \
  --data '{"route_id":"qr-v021","prompt":"参考图中的小船缓缓驶过石桥，水面自然泛起涟漪。","duration":15,"resolution":"720p","ratio":"16:9","task_mode":"references","references":[{"id":"bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb","role":"reference_image"}]}'

{
  "id": "aaaaaaaa-aaaa-5aaa-8aaa-aaaaaaaaaaaa",
  "model": "qr-v021",
  "status": "queued",
  "progress": null,
  "price_credits": 15,
  "duration": 15,
  "resolution": "720p",
  "ratio": "16:9",
  "created_at": 1792324800000,
  "completed_at": null,
  "expires_at": null,
  "error": null,
  "download_url": null
}

curl 'https://qorastudio.cn/api/v1/video/generations/aaaaaaaa-aaaa-5aaa-8aaa-aaaaaaaaaaaa' \
  -H 'Authorization: Bearer YOUR_QORA_API_KEY'

{
  "data": {
    "id": "aaaaaaaa-aaaa-5aaa-8aaa-aaaaaaaaaaaa",
    "model": "qr-v021",
    "status": "completed",
    "progress": 100,
    "price_credits": 15,
    "duration": 15,
    "resolution": "720p",
    "ratio": "16:9",
    "created_at": 1792324800000,
    "completed_at": 1792325160000,
    "expires_at": 1792584360000,
    "error": null,
    "download_url": "/api/v1/video/generations/aaaaaaaa-aaaa-5aaa-8aaa-aaaaaaaaaaaa/content"
  }
}

curl 'https://qorastudio.cn/api/v1/video/generations' \
  -H 'Authorization: Bearer YOUR_QORA_API_KEY'

{
  "data": [
    {
      "id": "aaaaaaaa-aaaa-5aaa-8aaa-aaaaaaaaaaaa",
      "model": "qr-v021",
      "status": "queued",
      "progress": null,
      "price_credits": 15,
      "duration": 15,
      "resolution": "720p",
      "ratio": "16:9",
      "created_at": 1792324800000,
      "completed_at": null,
      "expires_at": null,
      "error": null,
      "download_url": null
    }
  ]
}

curl -fL -C - --connect-timeout 20 --max-time 600 \
  --retry 8 --retry-delay 5 --retry-max-time 1800 --retry-all-errors \
  'https://qorastudio.cn/api/v1/video/generations/aaaaaaaa-aaaa-5aaa-8aaa-aaaaaaaaaaaa/content' \
  -H 'Authorization: Bearer YOUR_QORA_API_KEY' \
  -o qora-video.mp4.part

{
  "route_id": "qr-v042",
  "prompt": "参考图1作为人物参考，镜头平稳推进。",
  "duration": 30,
  "resolution": "720p",
  "ratio": "16:9",
  "task_mode": "references",
  "references": [
    {
      "id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
      "role": "reference_image"
    }
  ]
}

{
  "route_id": "qr-v042",
  "prompt": "参考图1作为人物参考，镜头平稳推进。",
  "duration": 30,
  "resolution": "720p",
  "ratio": "16:9",
  "images": [
    "https://your-bucket.oss-cn-hongkong.aliyuncs.com/reference.png"
  ]
}

{
  "route_id": "qr-v038",
  "prompt": "纸船缓缓漂过水面，镜头保持平稳。",
  "duration": 30,
  "resolution": "720p",
  "ratio": "16:9",
  "task_mode": "text"
}

{
  "error": {
    "code": "insufficient_credits",
    "message": "积分余额不足，请先兑换卡密"
  }
}

$env:QORA_API_KEY='替换为自己的Key'
$env:QORA_ORDER_ID='my-order-20261018-001'
$env:QORA_REFERENCE_FILE='C:\素材\reference.png'
node .\qora-mini.mjs

# 已有任务续查时，只需Key和已保存的任务号，不再次生成
$env:QORA_JOB_ID='aaaaaaaa-aaaa-5aaa-8aaa-aaaaaaaaaaaa'
node .\qora-mini.mjs

// Node.js 18+，保存为 qora-mini.mjs。首次运行可能消耗15积分。
// 必填：QORA_API_KEY、QORA_ORDER_ID、QORA_REFERENCE_FILE（PNG）。
// 续查已有任务：只需 QORA_API_KEY、QORA_JOB_ID，不会再次提交生成。
import fs from 'node:fs/promises';
import path from 'node:path';
import {createHash} from 'node:crypto';
import {createWriteStream} from 'node:fs';
import {Readable} from 'node:stream';
import {pipeline} from 'node:stream/promises';
const base='https://qorastudio.cn/api/v1';
const key=process.env.QORA_API_KEY;
if(!key)throw Error('请设置 QORA_API_KEY');
const auth={Authorization:'Bearer '+key};
const sleep=ms=>new Promise(resolve=>setTimeout(resolve,ms));
async function json(path,options={}){
 for(let attempt=0;;attempt++){
  const r=await fetch(base+path,{...options,headers:{...auth,...options.headers},signal:AbortSignal.timeout(90000)});
  const d=await r.json();
  if(r.status===429&&attempt<40){await sleep(Math.max(1,Math.min(60,Number(r.headers.get('Retry-After'))||15))*1000);continue;}
  if(!r.ok)throw Error(d.error?.message||'HTTP '+r.status);
  return d;
 }
}
async function uploadReference(bytes,type,filename){
 async function control(body){
  for(let attempt=0;;attempt++){
   let r;
   try{r=await fetch('https://qorastudio.cn/api/v1/assets/direct',{method:'POST',redirect:'error',headers:{Authorization:'Bearer '+key,'Content-Type':'application/json'},body:JSON.stringify(body),signal:AbortSignal.timeout(120000)});}catch(error){if(attempt>=2)throw error;await new Promise(r=>setTimeout(r,1000*(attempt+1)));continue;}
   const d=await r.json();if(r.ok)return d;
   const retry=[408,429,500,502,503,504].includes(r.status)||r.status===409&&['upload_unconfirmed','upload_in_progress'].includes(d.error?.code);
   if(!retry||attempt>=2)throw Error(d.error?.message||'上传控制请求未完成');
   await new Promise(resolve=>setTimeout(resolve,Math.max(1,Math.min(30,Number(r.headers.get('Retry-After'))||2))*1000));
  }
 }
 const authorized=await control({action:'authorize',source:createHash('sha256').update(bytes).digest('hex'),size:bytes.length,type});
 let ready=authorized;
 if(authorized.status!=='ready'){
  const host=new URL(authorized.host);
  if(authorized.status!=='uploading'||authorized.upload_mode!=='post_form'||host.origin!=='https://qorastudio.oss-cn-hongkong.aliyuncs.com'||host.username||host.password||host.pathname!=='/'||host.search||host.hash||!authorized.fields)throw Error('直传授权响应异常');
  const form=new FormData();for(const [name,value]of Object.entries(authorized.fields))form.append(name,value);
  form.append('file',new Blob([bytes],{type}),path.basename(filename));
  // 文件正文只发到本站OSS；这里不能携带Qora Bearer密钥。
  try{const uploaded=await fetch(host,{method:'POST',redirect:'error',body:form,signal:AbortSignal.timeout(600000)});await uploaded.body?.cancel();}catch{}
  // 上传响应丢失也先确认同一id，避免重复发送整份文件。
  try{ready=await control({action:'complete',id:authorized.id});}catch(error){throw Error('素材编号 '+authorized.id+' 尚未确认，请保留编号并重试complete；'+error.message);}
 }
 if(ready.status!=='ready'||ready.id!==authorized.id||ready.expired||ready.expires_at!=null&&ready.expires_at<=Date.now())throw Error('素材尚未可用，不能提交生成');
 return ready;
}
let id=process.env.QORA_JOB_ID;
if(!id){
 const order=process.env.QORA_ORDER_ID,filename=process.env.QORA_REFERENCE_FILE;
 if(!order||!filename)throw Error('首次生成须设置固定订单号和PNG参考图路径');
 const bytes=await fs.readFile(filename);
 const asset=await uploadReference(bytes,'image/png',filename);
 const body={route_id:'qr-v021',prompt:'参考图中的小船缓缓驶过石桥，水面自然泛起涟漪。',duration:15,resolution:'720p',ratio:'16:9',task_mode:'references',references:[{id:asset.id,role:'reference_image'}]};
 const options={method:'POST',headers:{'Content-Type':'application/json','Idempotency-Key':order},body:JSON.stringify(body)};
 let {data:q}=await json('/video/quotes',options);
 const quoteDeadline=Date.now()+300000;
 for(;q.retry_after_seconds&&Date.now()<quoteDeadline;){await sleep(Math.max(1,Math.min(30,q.retry_after_seconds))*1000);({data:q}=await json('/video/quotes',options));}
 if(q.status==='estimating')throw Error('估价仍在处理，请保留订单号，稍后用相同参数重试');
 if(q.status==='quoted'){
  if(!q.quote_ready||q.price_credits>15)throw Error('报价未就绪或超过本示例15积分预算，未提交');
  const job=await json('/video/generations',options);id=job.id;
 }else{id=q.id;}
 await fs.writeFile('qora-job.json',JSON.stringify({id,order},null,2));
}
if(!/^[0-9a-f-]{36}$/i.test(id))throw Error('任务号格式无效');
console.log('请保存任务号：'+id+'；中断后可设置 QORA_JOB_ID 续查');
for(let attempt=0;attempt<120;attempt++){
 let r;
 try{r=await fetch(base+'/video/generations/'+id,{headers:auth,signal:AbortSignal.timeout(90000)});}catch{await sleep(30000);continue;}
 if(r.status===408||r.status===429||r.status>=500){await sleep(30000);continue;}
 const d=await r.json();if(!r.ok)throw Error(JSON.stringify(d));const job=d.data;
 if(job.status==='failed'||job.status==='expired'||job.status==='delivery_blocked')throw Error(JSON.stringify(job.error||job));
 if(job.status==='uncertain')throw Error('任务仍在核对，请保留任务号，不要更换订单重新生成');
 if(job.status==='quoted'||job.status==='estimating')throw Error('尚未入队，请保留原订单号和参数，稍后重试原提交');
 if(job.status==='completed'){
  const expected='/api/v1/video/generations/'+id+'/content';
  const direct=job.download_url?.startsWith('https://qorastudio.oss-cn-hongkong.aliyuncs.com/qora/');
  if(!direct&&job.download_url!==expected)throw Error('下载地址异常');
  const file=await fetch(direct?job.download_url:'https://qorastudio.cn'+expected,{headers:direct?{}:auth,signal:AbortSignal.timeout(1800000)});
  if(!file.ok||!file.headers.get('content-type')?.startsWith('video/'))throw Error('下载未完成，请用同任务号续查，勿重复生成');
  const extension=file.headers.get('content-type').startsWith('video/webm')?'webm':'mp4';
  const output='qora-video.'+extension;
  await pipeline(Readable.fromWeb(file.body),createWriteStream(output+'.part'));
  const stored=await fs.open(output+'.part','r');
  try{const head=Buffer.alloc(12),{bytesRead}=await stored.read(head,0,12,0),size=(await stored.stat()).size,expected=file.headers.get('content-length');
   if(bytesRead<12||(extension==='mp4'?head.subarray(4,8).toString()!=='ftyp':head.subarray(0,4).toString('hex')!=='1a45dfa3')||expected!==null&&Number(expected)!==size)throw Error('文件不完整或视频格式不符，请保留任务号重新下载');
  }finally{await stored.close();}
  await fs.rename(output+'.part',output);console.log('已保存 '+output);process.exit(0);
 }
 console.log(job.status,job.progress??'');await sleep(30000);
}
throw Error('本轮等待结束，请保存任务号并续查，不要创建新订单');

# Python 3 标准库，无需安装第三方包。仅查询/下载已有任务，不提交生成。
# 设置环境变量 QORA_API_KEY、QORA_JOB_ID 后运行。
import os,json,time,urllib.request,urllib.error,shutil
key=os.environ['QORA_API_KEY'];job_id=os.environ['QORA_JOB_ID']
base='https://qorastudio.cn';headers={'Authorization':'Bearer '+key}
for attempt in range(120):
    req=urllib.request.Request(base+'/api/v1/video/generations/'+job_id,headers=headers)
    try:
        with urllib.request.urlopen(req,timeout=90) as response:
            job=json.load(response)['data']
    except urllib.error.HTTPError as error:
        if error.code in (408,429) or error.code>=500:
            time.sleep(30);continue
        raise
    except urllib.error.URLError:
        time.sleep(30);continue
    state=job['status']
    if state in ('failed','expired','delivery_blocked','uncertain','quoted','estimating'):
        raise RuntimeError('请保留任务号处理当前状态，不要创建新订单：'+json.dumps(job,ensure_ascii=False))
    if state=='completed':
        expected='/api/v1/video/generations/'+job_id+'/content'
        link=job.get('download_url') or ''
        direct=link.startswith('https://qorastudio.oss-cn-hongkong.aliyuncs.com/qora/')
        if not direct and link!=expected:raise RuntimeError('下载地址异常')
        req=urllib.request.Request(link if direct else base+expected,headers={} if direct else headers)
        with urllib.request.urlopen(req,timeout=120) as response:
            mime=response.headers.get('Content-Type','').split(';')[0]
            if mime not in ('video/mp4','video/webm'):raise RuntimeError('返回内容不是视频')
            head=response.read(12)
            valid=head[4:8]==b'ftyp' if mime=='video/mp4' else head[:4]==bytes([26,69,223,163])
            if not valid:raise RuntimeError('视频文件头无效')
            filename='qora-video.'+('webm' if mime=='video/webm' else 'mp4')
            with open(filename,'wb') as output:
                output.write(head);shutil.copyfileobj(response,output)
        print('已保存',filename);break
    print(state,job.get('progress'));time.sleep(30)
else:
    raise RuntimeError('本轮等待结束，请用相同任务号续查，不要重新生成')