API 文档

快速开始

我们的API完全兼容OpenAI API格式，您可以使用任何OpenAI SDK直接对接。

Base URL
https://ceshi.xiguayuanma.cn/api/v1

认证方式

所有API请求都需要在HTTP头部携带API密钥进行认证：

Authorization: Bearer YOUR_API_KEY
您可以在 控制台 中创建和管理API密钥。

Chat Completions

创建一个聊天补全请求。

请求
POST /v1/chat/completions
请求参数
参数类型必填说明
modelstring是模型ID
messagesarray是消息数组
streamboolean否是否流式输出
请求示例
{
    "model": "gemini-pro",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": false
}

图片生成 (Imagen)

使用 Google Imagen 模型生成图片，兼容 OpenAI DALL-E API 格式。

请求
POST /v1/images/generations
请求参数
参数类型必填说明
promptstring是图片描述文本
modelstring否模型ID（默认: imagen-3.0-generate-002）
ninteger否生成图片数量（默认: 1）
sizestring否图片尺寸（默认: 1024x1024）
response_formatstring否"b64_json" 或 "url"（默认: b64_json）
请求示例
{
    "prompt": "A cute cat wearing a space suit, digital art",
    "model": "imagen-3.0-generate-002",
    "n": 1,
    "size": "1024x1024"
}
响应示例
{
    "created": 1703123456,
    "data": [
        {"b64_json": "/9j/4AAQSkZJRg..."}
    ]
}
图片生成消耗更多积分，请确保账户余额充足。

获取模型列表

GET /v1/models

错误处理

状态码说明
200请求成功
401未认证或API密钥无效
402积分不足
403API密钥被禁用

代码示例

对话示例

Python
import openai

client = openai.OpenAI(
    base_url="https://ceshi.xiguayuanma.cn/api/v1",
    api_key="sk-your-api-key"
)

response = client.chat.completions.create(
    model="gemini-pro",
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)
cURL
curl https://ceshi.xiguayuanma.cn/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{"model": "gemini-pro", "messages": [{"role": "user", "content": "Hello!"}]}'

图片生成示例

Python
import openai
import base64

client = openai.OpenAI(
    base_url="https://ceshi.xiguayuanma.cn/api/v1",
    api_key="sk-your-api-key"
)

response = client.images.generate(
    model="imagen-3.0-generate-002",
    prompt="A cute cat wearing a space suit, digital art",
    n=1,
    size="1024x1024"
)

# 保存图片
image_data = base64.b64decode(response.data[0].b64_json)
with open("generated_image.png", "wb") as f:
    f.write(image_data)
cURL
curl https://ceshi.xiguayuanma.cn/api/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{"prompt": "A cute cat wearing a space suit", "n": 1}'