无限扩散 API 文档

curl -X POST "https://api.wxksai.com/gen/v1/generations" \
    -H "Authorization: Bearer sk-xxxx" \
    -H "Content-Type: application/json" \
    -d '{"model": "nano-banana-2", "prompt": "一只橘猫坐在窗台上，午后阳光，胶片质感", "size": "1K", "aspect_ratio": "1:1"}'
  

{"id": "task_xxxxxxxxxxxxxxxx", "object": "image", "status": "queued", "model": "nano-banana-2", "cost_points": 12, "result_url": null, "error": null, ...}

curl "https://api.wxksai.com/gen/v1/generations/task_xxxxxxxxxxxxxxxx" -H "Authorization: Bearer sk-xxxx"

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx

curl "https://api.wxksai.com/v1/models" -H "Authorization: Bearer sk-xxxx"

{"object": "list", "data": [{"id": "seedance-2.5-special2", "object": "model", "created": 1792551798, "owned_by": "wxks"}, ...]}

curl -X POST "https://api.wxksai.com/v1/videos" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-fast-720p-900-15s",
    "prompt": "雨夜便利店门口，暖黄灯光映在湿润街道上，固定镜头，自然写实",
    "duration": 15,
    "resolution": "720p",
    "ratio": "16:9",
    "imageUrls": [],
    "videoUrls": [],
    "audioUrls": []
  }' 

# 查询原任务；也可使用 /foke/v1/videos/{id}
curl "https://api.wxksai.com/v1/videos/task_xxxxxxxxxxxxxxxx" \
  -H "Authorization: Bearer sk-xxxx"

# 成功后下载；不要重新提交生成任务
curl -L -o result.mp4 \
  "https://api.wxksai.com/v1/videos/task_xxxxxxxxxxxxxxxx/content" \
  -H "Authorization: Bearer sk-xxxx"

curl -X POST "https://api.wxksai.com/openapi/v1/videos" \
  -H "Authorization: Bearer sk-xxxx" \
  -F "model=seedance2.5-buff" \
  -F "duration=10" \
  -F "ratio=9:16" \
  -F "prompt=[图1]中的女孩在海边奔跑，镜头缓慢跟随，黄昏逆光" \
  -F "image=@./girl.jpg"

curl -X POST "https://api.wxksai.com/openapi/v1/videos" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd25-v",
    "duration": 30,
    "ratio": "9:16",
    "prompt": "[图1]中的男生模仿[视频1]中的舞蹈动作，伴着[音频1]的节奏跳舞",
    "image_urls": ["https://example.com/person.jpg"],
    "videos": ["https://example.com/dance.mp4"],
    "audios": ["https://example.com/bgm.mp3"]
  }'

{
  "id": "task_xxxxxxxxxxxxxxxx",
  "status": "queued",
  "progress": 0,
  "error": null,
  "videoUrl": null,
  "duration": 10,
  "aspectRatio": "9:16",
  "creditCost": 7.8,
  "notice": null,
  "createdAt": "2026-10-21T08:00:00Z",
  "completedAt": null
}

# 查询（建议每 5–10 秒一次，status 为 success 或 failed 时停止）
curl "https://api.wxksai.com/openapi/v1/videos/task_xxxxxxxxxxxxxxxx" -H "Authorization: Bearer sk-xxxx"

# 下载 mp4（会 302 跳转到文件地址，需加 -L）
curl -L -o result.mp4 "https://api.wxksai.com/openapi/v1/videos/task_xxxxxxxxxxxxxxxx/file" -H "Authorization: Bearer sk-xxxx"

curl -X POST "https://api.wxksai.com/openapi/v1/images" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "banana-pro",
    "prompt": "极简风格的咖啡品牌海报，标题文字「晨光」",
    "params": {"aspectRatio": "3:4", "imageSize": "2K", "n": 2}
  }'

{"task_id": "task_xxxxxxxxxxxxxxxx", "task_ids": ["task_xxxxxxxxxxxxxxxx", "task_xxxxxxxxxxxxxxxx-1"], "status": "queued", "result_url": null, "creditCost": 0.65}

curl "https://api.wxksai.com/openapi/v1/images/task_xxxxxxxxxxxxxxxx" -H "Authorization: Bearer sk-xxxx"

{"task_id": "task_xxxxxxxxxxxxxxxx", "state": "success", "status": "success", "is_final": true, "progress": 100, "result_url": "https://api.wxksai.com/v1/tasks/task_xxxxxxxxxxxxxxxx/artifacts/image-0/content?access=...", "result_type": "image", "error": "", "cost": 0.325}

curl -X POST "https://api.wxksai.com/gen/v1/files" \
  -H "Authorization: Bearer sk-xxxx" \
  -F "file=@./product.png"

{"id": "file_xxxxxxxxxxxxxxxx", "object": "file", ...}

curl -X POST "https://api.wxksai.com/gen/v1/files?model=seedance-2.5-special2" \
  -H "Authorization: Bearer sk-xxxx" \
  -F "file=@./reference.jpg"

curl -X POST "https://api.wxksai.com/gen/v1/generations" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-image-2-line1", "prompt": "电影感人物海报，霓虹雨夜", "size": "2K", "aspect_ratio": "9:16"}'

curl -X POST "https://api.wxksai.com/gen/v1/generations" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "prompt": "图片1中的产品在桌面上缓慢旋转，柔和棚拍灯光",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "reference_images": ["file_xxxxxxxxxxxxxxxx"]
  }'

curl "https://api.wxksai.com/gen/v1/generations/task_xxxxxxxxxxxxxxxx" -H "Authorization: Bearer sk-xxxx"

{
  "id": "task_xxxxxxxxxxxxxxxx",
  "object": "video",
  "status": "succeeded",
  "model": "wan3.0-video",
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "duration": 5,
  "cost_points": 114,
  "refunded": false,
  "result_url": "https://api.wxksai.com/v1/tasks/task_xxxxxxxxxxxxxxxx/artifacts/result/content?access=...",
  "error": null,
  "created_at": "2026-10-21T04:31:30.787Z",
  "completed_at": "2026-10-21T04:34:43.891Z"
}

curl -X POST "https://api.wxksai.com/gen/v1/generations/task_xxxxxxxxxxxxxxxx/cancel" -H "Authorization: Bearer sk-xxxx"

# 开放接口（/openapi/v1/）
{"detail": "模型「xxx」不存在或已停用"}

# 生成接口（/gen/v1/）
{"error": {"code": "invalid_request", "message": "模型「xxx」不存在或已停用", "type": "invalid_request_error", "request_id": "2026..."}}

# 鉴权 / 余额等通用错误（两组接口相同）
{"error": {"code": "", "message": "Invalid token (request id: 2026...)", "type": "new_api_error"}}

import time, requests

BASE = "https://api.wxksai.com"
H = {"Authorization": "Bearer sk-xxxx"}

# 1) 提交任务：本地图片直接上传（公网图片可改用 data 里的 image_urls）
with open("girl.jpg", "rb") as f:
    r = requests.post(f"{BASE}/openapi/v1/videos", headers=H,
                      data={"model": "seedance2.5-buff", "duration": "10", "ratio": "9:16",
                            "prompt": "[图1]中的女孩在海边奔跑，镜头缓慢跟随"},
                      files=[("image", ("girl.jpg", f, "image/jpeg"))])
if r.status_code != 202:
    raise SystemExit(f"提交失败 {r.status_code}: {r.text}")
task = r.json()
print("任务ID:", task["id"], "费用 ¥", task["creditCost"])

# 2) 轮询
while True:
    time.sleep(8)
    s = requests.get(f"{BASE}/openapi/v1/videos/{task['id']}", headers=H).json()
    print(s["status"], s["progress"])
    if s["status"] in ("success", "failed"):
        break

# 3) 下载
if s["status"] == "success":
    with open("result.mp4", "wb") as out:
        out.write(requests.get(s["videoUrl"]).content)
    print("已保存 result.mp4")
else:
    print("生成失败（费用已退回）:", s["error"])

import time, requests

BASE = "https://api.wxksai.com"
H = {"Authorization": "Bearer sk-xxxx"}

# 1) 上传参考图（免费），得到文件 ID
with open("product.png", "rb") as f:
    up = requests.post(f"{BASE}/gen/v1/files", headers=H, params={"model": "wan3.0-video"}, files={"file": f})
up.raise_for_status()
file_id = up.json()["id"]

# 2) 创建任务
r = requests.post(f"{BASE}/gen/v1/generations", headers=H, json={
    "model": "wan3.0-video",
    "prompt": "图片1中的产品在桌面上缓慢旋转，柔和棚拍灯光",
    "resolution": "720p", "duration": 5, "aspect_ratio": "16:9",
    "reference_images": [file_id],
})
if r.status_code >= 300:
    raise SystemExit(f"提交失败 {r.status_code}: {r.text}")
g = r.json()

# 3) 轮询到终态
while g["status"] not in ("succeeded", "failed", "canceled", "review"):
    time.sleep(8)
    g = requests.get(f"{BASE}/gen/v1/generations/{g['id']}", headers=H).json()

if g["status"] == "succeeded":
    with open("result.mp4", "wb") as out:
        out.write(requests.get(g["result_url"]).content)
    print("完成，费用 ¥%.2f" % (g["cost_points"] / 100))
else:
    print(g["status"], g.get("error"))