词元 API 文档

Appearance

GPT 生图教程 ​

词元 API 支持通过网页和 API 两种方式使用 GPT 图片能力。网页适合直接操作，API 适合接入自己的应用、工作流或自动化脚本。

生图网页 ​

如果只是手动生成、预览或下载图片，可以直接使用生图网页：

text
https://gptimage.ciyuanapi.xyz/

网页里需要填写词元 API 的接口地址和 API Key。接口地址通常填写：

text
https://code.ciyuanapi.xyz

或按页面要求填写完整 OpenAI 兼容 Base URL：

text
https://code.ciyuanapi.xyz/v1

API 入口 ​

OpenAI 兼容 Base URL：

text
https://code.ciyuanapi.xyz/v1

常用图片接口：

功能请求路径
文生图POST /v1/images/generations
图生图 / 图片编辑POST /v1/images/edits

完整请求地址示例：

text
https://code.ciyuanapi.xyz/v1/images/generations
https://code.ciyuanapi.xyz/v1/images/edits

文生图示例 ​

文生图使用 JSON 请求体：

bash
curl https://code.ciyuanapi.xyz/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫坐在窗边，柔和自然光，写实摄影风格",
    "size": "1024x1024",
    "quality": "standard",
    "n": 1
  }'

PowerShell 示例：

powershell
$body = @{
  model = "gpt-image-2"
  prompt = "一只橘猫坐在窗边，柔和自然光，写实摄影风格"
  size = "1024x1024"
  quality = "standard"
  n = 1
} | ConvertTo-Json -Depth 10

Invoke-RestMethod `
  -Uri "https://code.ciyuanapi.xyz/v1/images/generations" `
  -Method Post `
  -Headers @{ Authorization = "Bearer $env:API_KEY" } `
  -ContentType "application/json" `
  -Body $body

图生图 / 图片编辑示例 ​

图片编辑通常使用 multipart/form-data 上传图片文件：

bash
curl https://code.ciyuanapi.xyz/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=gpt-image-2" \
  -F "image=@./input.png" \
  -F "prompt=把背景换成干净的白色摄影棚，主体保持不变" \
  -F "size=1024x1024"

如果客户端支持传图片 URL，也可以按客户端说明填写 URL；如果接口报参数错误，建议先把图片下载为本地文件，再用 image=@文件路径 上传。

常用参数 ​

参数说明
model图片模型名，例如 gpt-image-2
prompt图片提示词
size图片尺寸，例如 1024x1024、1536x1024、2880x2880
quality质量档位，例如 standard
n生成数量
stream是否开启流式返回，客户端支持时再开启
partial_images流式预览图数量，通常配合 stream 使用

不同分组和渠道支持的尺寸、质量、流式能力可能不同。请以控制台中当前模型和分组说明为准。

返回结果 ​

接口通常返回图片 URL 或图片数据。常见返回结构类似：

json
{
  "data": [
    {
      "url": "https://..."
    }
  ]
}

如果你的客户端只支持 URL 返回，请确认所选渠道支持返回图片链接。

提示词建议 ​

提示词尽量描述清楚主体、场景、风格、光线和画幅：

text
一只橘猫坐在窗边，柔和自然光，写实摄影风格，浅色背景，细节清晰，1024x1024

复杂海报或电商图建议拆开说明：

  • 主体是什么。
  • 背景是什么。
  • 画面比例和构图。
  • 需要出现的文字。
  • 不希望出现的元素。

常见问题 ​

Model name not specified ​

请求体或表单里没有传 model，或字段名写错。

Invalid size ​

尺寸格式不正确。图片接口通常需要 宽x高 格式，例如：

text
1024x1024
1536x1024
2880x2880

不要写成 square 这类别名，除非当前渠道明确支持。

400 参数错误 ​

常见原因：

  • 图片文件格式不支持。
  • 表单字段名写错。
  • size、quality、n 等参数超出当前渠道支持范围。
  • 图生图接口没有按 multipart/form-data 上传。

429 限流 ​

通常是账号、分组、渠道或上游正在限流。可以稍后重试，或切换到其他可用分组。

invalid character 'e' looking for beginning of value ​

这个报错通常不是提示词本身的问题，而是接口期望收到 JSON，但实际收到了一段普通文本或事件流内容。常见情况包括：

  • 上游返回了以 error 开头的纯文本错误。
  • 流式接口返回了 event: / data: 这类 SSE 内容，但当前链路按普通 JSON 解析。
  • 中转服务或上游代理返回了 HTML、Cloudflare 错误页、连接错误文本。
  • 图片渠道返回格式和 NewAPI 当前适配方式不一致。

排查时建议先关闭 stream 和 partial_images，用非流式请求重试；如果非流式正常、流式报错，多半是当前渠道的流式返回格式不兼容。还可以在控制台查看该次请求命中的渠道，并检查上游日志里的原始返回内容。

生成很慢或空输出 ​

复杂提示词、大尺寸、4K 图、流式预览都可能增加耗时。建议先用较小尺寸确认提示词可用，再提高分辨率。