一个标准接口，
接入持续扩展的模型。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["WANCHUAN_API_KEY"],
    base_url="https://api.wanchuanapi.com/v1",
    max_retries=0,  # 先核实请求结果；本示例不自动重试
)

result = client.chat.completions.create(
    extra_headers={"Idempotency-Key": os.environ["WANCHUAN_REQUEST_KEY"]},
    model="YOUR_MODEL_ID",
    messages=[{"role": "user", "content": "生成一条商品卖点"}],
    max_tokens=256,
)
print(result.choices[0].message.content)

模型价格使用 request_points_per_million_tokens / response_points_per_million_tokens；余额使用 total_points、held_points、available_points；账单使用 amount_points、held_change_points、balance_after_points；调用结算使用 charged_points、released_points，媒体任务另有 pending_points。控制台导出使用 amount_points 和 unit。

积分由账户现有换算设置展示；历史账目按读取时的设置折算，原始金额与价格快照不改写。配置不可用时不返回伪造零报价，points_configured 为 false 或积分字段缺省；请停止报价展示并提示稍后核对。待结算、冻结、释放和实际扣除必须分别展示。

客服 API 使用 Bearer API Key；受限 Key 需要 support 权限，浏览器登录 Cookie 不能替代 Key。列表仅包含当前租户，返回 {"object":"list","data":[...]}；创建成功返回 201 和 {"object":"support_ticket","ticket":{...}}。

平台服务费与模型用量费分别计算。每次请求绑定确认时的价格快照，之后价格调整不改写该请求的价格；结算依据与费用状态可在对应账单中核对。预留金额不等于已结算费用。Studio 生成需已开通且在有效期内的付费方案，模型用量另计。

WANCHUAN_API_KEY 为客户 Key，WANCHUAN_MEDIA_MODEL 为目录里的图片生视频模型。WANCHUAN_JOB_KEY 必须是本次任务固定且唯一的标识；请求超时后再次运行仍使用同一个标识和完全相同的参数，不能换键重提。

import json, os, time
from pathlib import Path
from urllib.request import Request, urlopen

base = "https://api.wanchuanapi.com"
key = os.environ["WANCHUAN_API_KEY"]
job_key = os.environ["WANCHUAN_JOB_KEY"]
model = os.environ["WANCHUAN_MEDIA_MODEL"]

def call(path, body=None, content_type="application/json", idem=None):
    headers = {"Authorization": "Bearer " + key}
    if body is not None:
        headers["Content-Type"] = content_type
    if idem:
        headers["Idempotency-Key"] = idem
    with urlopen(Request(base + path, data=body, headers=headers), timeout=60) as r:
        return json.load(r)

models = call("/v1/media/models")["data"]
assert any(m["id"] == model for m in models), "模型未授权，请先查询目录"
# 使用你拥有权限的 PNG；另核对所选模型的尺寸和输入限制。
uploaded = call("/v1/media/inputs", Path("reference.png").read_bytes(),
                "image/png", job_key + "-input")["input"]
assert uploaded["status"] == "ready"
print("保留输入 ID：", uploaded["id"])
payload = {"model": model, "prompt": "保持商品外观，镜头缓慢推进",
           "parameters": {"input_asset_ids": [uploaded["id"]],
                          "duration": 4, "resolution": "480p",
                          "provider_processing_acknowledged": True}}
# duration / resolution 必须按该模型目录中的参数范围修改。
job = call("/v1/media/jobs", json.dumps(payload).encode(), idem=job_key)
print("任务 ID：", job["id"])
for _ in range(120):
    job = call("/v1/media/jobs/" + job["id"])
    print(job["status"], job.get("progress", {}).get("stage"))
    if job["status"] == "succeeded":
        with urlopen(Request(base + "/v1/media/assets/" + job["asset_id"],
                     headers={"Authorization": "Bearer " + key}), timeout=60) as r:
            Path("result.mp4").write_bytes(r.read())
        break
    if job["status"] in {"failed", "cancelled", "expired", "submission_uncertain", "settlement_pending"}:
        raise RuntimeError("保留任务 ID 并核对详情，不自动重提：" + job["status"])
    time.sleep(5)
else:
    raise TimeoutError("停止轮询；保留原任务 ID，稍后继续 GET 查询")

查询和下载不创建新生成任务。输入与成片生命周期分别管理：确认不再使用、且无活动任务引用后，才显式调用 DELETE /v1/media/inputs/{input_id} 清理输入。示例不会自动删除素材。

curl https://api.wanchuanapi.com/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: YOUR_UNIQUE_RESPONSE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_RESPONSES_MODEL_ID","input":"你好","max_output_tokens":128,"store":false,"stream":true}'

流式响应为 text/event-stream，按 event 与 data 读取完整事件；response.output_text.delta 为文字增量，终态为 response.completed、response.incomplete 或 response.failed。函数调用由你的应用执行，再带回对应输出继续请求；平台不会代执行工具。不要把网络断开当成任务失败。

参数、返回结构与错误详见 OpenAPI。带有 Studio session API 标签的接口供工作台使用，采用登录会话与 CSRF，不属于客户 API Key 接入。