AI 图片生成 API 文档 (v1)

此端点提供安全的代理网关，允许您触发 AI 图像生成模型，而无需暴露您的底层服务提供商凭据。

1. 概述

Endpoint URL

https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image

Method

POST

Content-Type

application/json

2. 认证

所有请求必须在 HTTP Header 中包含安全令牌，以防止未经授权的访问。您必须从管理员处获取此令牌。

Header

X-Proxy-Token: YOUR_API_TOKEN_HERE

3. 请求参数

所有参数必须在 JSON 请求体中发送。

参数	类型	必填	描述
提示词	字符串	是	您想要生成的图像的文本描述。
尺寸	字符串	否	图像分辨率。默认值： `1024x1024`支持的值： `256x256`, `512x512`, `1024x1024`
生成图片的数量	integer	否	生成图片的数量。默认值： `1`推荐取值范围： `1–4`

4. cURL 示例

curl https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Proxy-Token: YOUR_API_TOKEN_HERE" \
  -d '{
    "prompt": "A futuristic mechanical cat, photorealistic",
    "size": "1024x1024",
    "n": 1
  }'

5. JavaScript 示例

📄

const API_TOKEN = 'YOUR_API_TOKEN_HERE'; // Replace with your actual token

fetch('https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-Proxy-Token': API_TOKEN
    },
    body: JSON.stringify({
        "prompt": "A futuristic mechanical cat, photorealistic",
        "size": "1024x1024",
        "n": 1
    })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

6. 响应格式

📄

5. Response Format

{
    "created": 1773223961,
    "data": [
        {
            "url": "https://example-image-url.com/generated.png"
        }
    ],
    "output_format": "png",
    "usage": {
        "total_tokens": 4182
    }
}

7. 错误响应

如果发生错误，API 将返回一条 JSON 格式的错误消息。

📋

{
  "error": {
    "message": "Invalid API token",
    "code": 403
  }
}

8. 状态码

代码	含义
200	请求成功
400	无效的请求参数
403	API 令牌无效或缺失
500	远程 AI 服务失败或请求超时