开发文档

兼容 OpenAI / Anthropic SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://qihua-api.totvan.cn/v1",
    api_key="qh_xxx",  # 在 控制台 -> API Key 创建
)
resp = client.chat.completions.create(
    model="claude-sonnet-4",
    messages=[{"role": "user", "content": "你好"}],
)

异步生成 (图 / 视频 / 音频 / 数字人)

POST /v1/images/generate
Authorization: Bearer qh_xxx
Idempotency-Key: <uuid v7>
Content-Type: application/json

{ "model": "midjourney-v7", "prompt": "...", "count": 1 }

-> 200
{ "task_id": "...", "status": "pending", "estimated_cost_credits": 50 }

GET /v1/tasks/{task_id} 轮询直到 status=succeeded

错误响应

所有错误统一返回如下结构:

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "balance too low",
    "message_zh": "余额不足",
    "request_id": "req_..."
  }
}