文章插图生成API提供基于专业文章配图模型AI的图片自动生成服务。只需用汉字描述想要的画面内容,即可获得一张 4:3 横版比例的插图,适合作为文章配图使用。
文章插图生成API提供基于专业文章配图模型AI的图片自动生成服务。只需用汉字描述想要的画面内容,即可获得一张 4:3 横版比例的插图,适合作为文章配图使用。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| prompt | string | 是 | 图片描述文字,用汉字详细描述画面内容、风格、色调等。不超过500字。系统会自动追加横版构图和4:3比例指令。 |
[
{
"name": "prompt",
"type": "string",
"required": true,
"description": "图片描述文字,用汉字详细描述画面内容、风格、色调等。不超过500字。系统会自动追加横版构图和4:3比例指令。",
"example": ""
}
]{"openapi":"3.1.1","info":{"title":"文章插图生成(专业版)","description":"文章插图生成API提供基于专业文章配图模型AI的图片自动生成服务。只需用汉字描述想要的画面内容,即可获得一张 4:3 横版比例的插图,适合作为文章配图使用。","version":"1.0.0"},"paths":{"/apis/gateway?api=articleimg":{"get":{"summary":"文章插图生成(专业版)","description":"文章插图生成API提供基于专业文章配图模型AI的图片自动生成服务。只需用汉字描述想要的画面内容,即可获得一张 4:3 横版比例的插图,适合作为文章配图使用。","parameters":[{"name":"prompt","in":"query","required":true,"schema":{"type":"string"},"description":"图片描述文字,用汉字详细描述画面内容、风格、色调等。不超过500字。系统会自动追加横版构图和4:3比例指令。"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"文章插图生成(专业版)","description":"文章插图生成API提供基于专业文章配图模型AI的图片自动生成服务。只需用汉字描述想要的画面内容,即可获得一张 4:3 横版比例的插图,适合作为文章配图使用。","parameters":[{"name":"prompt","in":"query","required":true,"schema":{"type":"string"},"description":"图片描述文字,用汉字详细描述画面内容、风格、色调等。不超过500字。系统会自动追加横版构图和4:3比例指令。"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"https://api.souxiaocha.com","description":"当前访问入口(https)"}]}
{"code":400,"msg":"请求失败 (HTTP 400)","data":{"api_name":"文章插图生成","endpoint_name":"文章插图生成","method":"POST","cost_points":0,"response":{"success":false,"error":"missing_prompt","message":"请提供图片描述参数(prompt)"}},"timestamp":1785227464}https://api.souxiaocha.com/apis/gateway?api=articleimgGET https://api.souxiaocha.com/apis/gateway?api=articleimg apikey=你的API密钥&prompt=请填写prompt
GET 参数放在查询字符串中。参数值请替换为实际有效值。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
prompt | string | 是 | 图片描述文字,用汉字详细描述画面内容、风格、色调等。不超过500字。系统会自动追加横版构图和4:3比例指令。 |
{"code":400,"msg":"请求失败 (HTTP 400)","data":{"api_name":"文章插图生成","endpoint_name":"文章插图生成","method":"POST","cost_points":0,"response":{"success":false,"error":"missing_prompt","message":"请提供图片描述参数(prompt)"}},"timestamp":1785227464}文章插图生成API提供基于专业文章配图模型AI的图片自动生成服务。只需用汉字描述想要的画面内容,即可获得一张 4:3 横版比例的插图,适合作为文章配图使用。
https://api.souxiaocha.com/apis/gateway?api=articleimg
GET / POST(业务参数 GET 通过 URL 传递,POST 支持表单或 JSON)
调用需携带平台密钥(用户中心「令牌管理」获取,SK- 开头):
key=SK-你的密钥X-API-Key: SK-你的密钥| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| prompt | string | 是 | 图片描述文字,用汉字详细描述画面内容、风格、色调等。不超过500字。系统会自动追加横版构图和4:3比例指令。 |
[
{"name": "prompt", "type": "string", "required": true, "description": "图片描述文字,用汉字详细描述画面内容、风格、色调等。不超过500字。系统会自动追加横版构图和4:3比例指令。"}
]
失败返回示例:
{"code":400,"msg":"请求失败 (HTTP 400)","data":{"api_name":"文章插图生成","endpoint_name":"文章插图生成","method":"POST","cost_points":0,"response":{"success":false,"error":"missing_prompt","message":"请提供图片描述参数(prompt)"}},"timestamp":1785227464}
| 参数名 | 类型 | 说明 |
|---|---|---|
| success | boolean | 请求是否成功 |
| data.prompt | string | 原始图片描述文字 |
| data.image_url | string | 生成的图片临时URL |
| data.ratio | string | 图片比例,固定为 "4:3" |
| data.generated_at | string | 图片生成时间,格式为 Y-m-d H:i:s |
curl "https://api.souxiaocha.com/apis/gateway?api=articleimg?key=SK-你的密钥&prompt=%E4%B8%80%E5%8F%AA%E6%A9%98%E7%8C%AB%E5%9C%A8%E7%AA%97%E5%8F%B0%E4%B8%8A%E6%99%92%E5%A4%AA%E9%98%B3%EF%BC%8C%E6%B8%A9%E6%9A%96%E9%98%B3%E5%85%89%EF%BC%8C%E9%AB%98%E6%B8%85%E5%86%99%E5%AE%9E"
上游业务级错误:
| code | msg | 描述 |
|---|---|---|
| 400 | missing_prompt | 缺少图片描述参数 |
| 400 | prompt_too_long | 图片描述超过500字 |
| 401 | invalid_api_key | API密钥无效或未提供 |
| 405 | method_not_allowed | 请求方法不允许,仅支持POST |
| 500 | generation_failed | 图片生成失败 |
平台级错误(errcode):11001 缺少密钥 / 11002 密钥无效或已禁用 / 11005 接口禁用 / 11006 接口维护 / 11010 积分不足 / 11018 请求方式不允许。
失败时请以响应体中的 code / errcode 与 msg 判断。
2026-09-24
curl "https://api.souxiaocha.com/apis/gateway?api=articleimg?key=SK-你的密钥&prompt=%E4%B8%80%E5%8F%AA%E6%A9%98%E7%8C%AB%E5%9C%A8%E7%AA%97%E5%8F%B0%E4%B8%8A%E6%99%92%E5%A4%AA%E9%98%B3%EF%BC%8C%E6%B8%A9%E6%9A%96%E9%98%B3%E5%85%89%EF%BC%8C%E9%AB%98%E6%B8%85%E5%86%99%E5%AE%9E"
// 结果将在此处显示