📖 API文档

大西瓜API 提供与 OpenAI 兼容的 文本对话与图像 / 视频 / 音乐生成接口：文本对话支持多轮上下文与流式输出；图像支持文生图、图生图与异步任务轮询。第三方应用、开源项目可用 OpenAI 兼容方式直接对接。

🔑 认证方式

所有 API 请求在 HTTP 头中携带 API 密钥：

Base URL：https://image.wxfl.mobi/v1

💬 文本对话（Chat Completions）

提供与 OpenAI Chat Completions 完全兼容的文本对话接口，支持多轮上下文与流式输出（SSE）。把 OpenAI SDK 的 base_url 指向本站即可无缝接入。

请求参数

可用文本模型与价格（元 / 100 万 tokens）

非流式请求（curl）

curl -X POST https://image.wxfl.mobi/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3-flash",
    "messages": [
      {"role": "system", "content": "你是一个乐于助人的助手"},
      {"role": "user", "content": "用一句话介绍你自己"}
    ],
    "stream": false
  }'

非流式响应示例

{
  "id": "chat_xxx",
  "model": "glm-5.3-flash",
  "choices": [
    {"index": 0, "message": {"role": "assistant", "content": "你好！我是……"}, "finish_reason": "stop"}
  ],
  "usage": {"prompt_tokens": 16, "completion_tokens": 5, "total_tokens": 21}
}

流式请求（SSE）

curl -N -X POST https://image.wxfl.mobi/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "写一句晚安"}],
    "stream": true
  }'

流式以 data: {...} 逐行返回增量内容（choices[0].delta.content），结束前返回带 usage 的分片，最后以 data: [DONE] 结束。推理模型（deepseek / glm）的思考过程通过 delta.reasoning_content 原样透传，思考内容不计入正文输出计费。

多轮对话

把历史 user / assistant 消息按顺序放进 messages，模型即可保持上下文：

"messages": [
  {"role": "user",      "content": "帮我写一首伤感的流行歌"},
  {"role": "assistant", "content": "《灯还亮着》……"},
  {"role": "user",      "content": "把副歌改得更释然一些"}
]

Python（OpenAI SDK）示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxx",
    base_url="https://image.wxfl.mobi/v1",
)

resp = client.chat.completions.create(
    model="glm-5.3-flash",
    messages=[{"role": "user", "content": "你好"}],
    stream=False,
)
print(resp.choices[0].message.content)
print(resp.usage)

💰 查询账户余额

携带 API 密钥查询该密钥所属账户的余额（元）。

curl https://image.wxfl.mobi/api/v1/balance \
  -H "Authorization: Bearer sk-xxxxxxxx"

# 返回示例
# {"balance": 6.39, "quota": 100000000, "used_quota": 0}

🖼️ 文生图 / 图生图

请求参数

文生图请求示例

图生图请求示例

gpt-image-2.5 系列请求示例

异步响应示例（提交成功）

🔄 查询异步任务结果

用提交时返回的 task_id 轮询任务状态，直到 status 为 completed 即可拿到图片 URL。

请求示例

完成响应示例

📋 模型列表

获取当前已开放的全部模型列表（含文本、图片、视频、音乐）。其中文本模型用于 /v1/chat/completions，其余用于生成接口。

🎯 模型可用性与分档计费（重要）

本站采用白名单机制：只有已配置价格的「模型 + 档次」才会开放调用；未配置价格的模型或档次，即使支持也会被拦截，返回 404 model_not_found，不会生成、不会扣费。模型广场与站内 AI 生图也只展示已开放的模型。

三种指定模型 / 档次的方式

🚦 错误码

💰 模型与价格

⚠️ 各渠道注意事项

异步接口（需轮询）

• 异步任务，返回 task_id，需轮询查询
• size 支持比例字符串（1:1、9:16 等）和像素格式
• 任务查询端点统一用 GET /v1/images/generations/{task_id}
• 图生图参数 image_urls 为 URL 数组
• 多档模型需在 model 名后加 -1k / -2k / -4k 后缀区分分辨率档位

同步接口（直接返回）

• 同步返回，POST 后直接返回图片数据（b64_json），无需轮询
• 图生图时自动下载 image_urls 图片并转发
• size 建议用像素格式（1024x1024）

🐍 Python 调用示例

\U0001f3ac 文生视频 / 图生视频

使用同一个提交接口 /v1/images/generations，通过 model 参数指定视频模型即可。视频生成需要 10-20 分钟，提交后返回 task_id，用查询接口轮询结果。

请求地址

参数说明

文生视频请求示例

curl -X POST https://image.wxfl.mobi/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "H3-769p-竖-15s",
    "prompt": "A beautiful woman walking in a park, natural movement, cinematic lighting, smooth camera, 4k quality"
  }'

图生视频请求示例

curl -X POST https://image.wxfl.mobi/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "H3-769p-竖-15s",
    "prompt": "The person starts walking forward, cinematic lighting",
    "image": "https://example.com/reference.jpg"
  }'

提交响应

{
  "task_id": "task_abc123",
  "status": "RUNNING",
  "model": "H3-769p-竖-15s"
}

\U0001f3b5 文生音乐（AI生歌）

同样使用 /v1/images/generations，指定音乐模型即可。音乐生成约需 1-3 分钟。

参数说明

请求示例

curl -X POST https://image.wxfl.mobi/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YuE2",
    "prompt": "[verse]\n阳光洒满操场\n笑声回荡在角落\n[chorus]\n青春永远不会散场"
  }'

❓ 常见问题

1. 如何获取 API 密钥？

登录后进入 API令牌 页面，点击"创建令牌"即可获取。

2. 提交后多久能拿到图片？

F接口和T接口为异步任务，通常 10-60 秒完成，用 task_id 轮询即可。TT接口同步返回，请求后直接拿到图片。

3. 图生图怎么用？

在请求中加 image_urls 参数（参考图 URL 数组），自动下载并适配格式。

4. 调用失败会扣费吗？

不会，只有成功生成才扣费。轮询到失败会立即自动退款；即使你提交后不主动查询，平台也会每 60 秒主动核对在途任务，对失败或超时（约 30 分钟仍无结果）的任务自动退款，款项原路退回账户余额，可在「余额流水」中查看。

5. 余额不足怎么办？

请联系管理员充值，或在个人中心查看充值方式。余额不足时调用会被拦截并返回错误。

6. 为什么返回 404 model_not_found？

说明该模型或你指定的档次未开放。多档模型请在模型名后加 -1k/-2k/-4k 后缀，调用前可先通过 GET /v1/models 或模型广场确认当前可用的模型与档次。