8848API 图片生成接口完整参考

提供真实接口路径、可用模型、curl/Python 示例、返回格式和排障流程。

✅ 支持 OpenAI-compatible Images API

8848API 模型列表 ↗查看 8848API 模型 →

8848API 信息

Base URL

https://api.884819.xyz/v1

API Key

控制台 → 令牌管理 → 添加令牌

协议要求

OpenAI-compatible Images API：POST /v1/images/generations

1. 选择真正的生图模型

gemini-3.1-flash-image
gpt-image-2
grok-imagine-image
grok-imagine-image-quality

grok-4.20-image 是图片理解模型，不是生图模型。视频模型也不能调用图片接口。

2. curl 最小测试

curl https://api.884819.xyz/v1/images/generations \
  -H "Authorization: Bearer 你的 sk- 密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴登山帽的金丝猴，雪山日出，电影感"
  }'

响应可能返回图片 URL 或 base64，取决于模型和上游实现。先保存完整 JSON，不要只假设固定字段。

3. Python 示例

import requests

r = requests.post(
    "https://api.884819.xyz/v1/images/generations",
    headers={"Authorization": "Bearer 你的 sk- 密钥"},
    json={"model": "gpt-image-2", "prompt": "极简科技公司 Logo"},
    timeout=180,
)
r.raise_for_status()
print(r.json())

4. 客户端接入检查

客户端必须明确支持 Image Generation / Images API。
聊天框支持上传图片，不代表支持生成图片。
设置单独的 Image Model，并填写完整模型 ID。
先做单张、小尺寸测试，再批量生成。

错误排查

模型只返回文字：调用了聊天接口，不是 images/generations。
404：检查路径和 Base URL，不要出现 /v1/v1。
model not found：模型 ID 拼错或当前令牌无权使用。
超时：生图耗时高于文本，请提高客户端超时。
费用异常：图片模型通常按次计费，正式批量前先看模型页面。