ai-image/docs.md

# 图像模型 API 文档

本文档整理 GPT Image 和 Grok Image 模型的 API 信息、调用示例、支持参数及速率限制。

## 通用信息

- API 基础地址：`https://api.slomerex.xyz/v1`
- 认证方式：`Authorization: Bearer <TOKEN>`
- Anthropic 格式的端点也接受 `x-api-key` 请求头。
- 可在「令牌」页面生成 API Key，并按模型、分组、IP、速率等维度进行授权。
- 示例中的 `<YOUR_API_KEY>` 请替换为令牌设置中的 API Key。

## 模型列表

| 模型 | 提供方 | 计费方式 |
|---|---|---|
| `gpt-image-2-1K` | OpenAI | 按次计费 |
| `gpt-image-2-2K` | OpenAI | 按次计费 |
| `gpt-image-2-4K` | OpenAI | 按次计费 |
| `grok-imagine-image-lite` | xAI | 按次计费 |

---

## gpt-image-2-1K

### 调用示例

```python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.slomerex.xyz/v1",
    api_key="<YOUR_API_KEY>",
)

completion = client.chat.completions.create(
    model="gpt-image-2-1K",
    messages=[
        {"role": "user", "content": "Explain quantum entanglement in one paragraph."}
    ],
)

print(completion.choices[0].message.content)
```

### 支持的参数

| 参数 | 类型 | 默认值 / 范围 | 说明 |
|---|---|---|---|
| `prompt` | `string` | 必填 | 想要生成图像的文字描述 |
| `size` | `enum` | `1024x1024` | 输出图像尺寸 |
| `quality` | `enum` | `standard` | 生成质量预设 |
| `style` | `enum` | `vivid` | 画风 |
| `n` | `integer` | `1`，范围 `1 ~ 10` | 生成的图像数量 |
| `response_format` | `enum` | `url` | 图像结果的返回方式 |

### 速率限制

| 分组 | RPM | TPM | RPD |
|---|---:|---:|---:|
| Gpt Image | 50 | — | 800 |

---

## gpt-image-2-2K

### 调用示例

```python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.slomerex.xyz/v1",
    api_key="<YOUR_API_KEY>",
)

completion = client.chat.completions.create(
    model="gpt-image-2-2K",
    messages=[
        {"role": "user", "content": "Explain quantum entanglement in one paragraph."}
    ],
)

print(completion.choices[0].message.content)
```

### 支持的参数

| 参数 | 类型 | 默认值 / 范围 | 说明 |
|---|---|---|---|
| `prompt` | `string` | 必填 | 想要生成图像的文字描述 |
| `size` | `enum` | `1024x1024` | 输出图像尺寸 |
| `quality` | `enum` | `standard` | 生成质量预设 |
| `style` | `enum` | `vivid` | 画风 |
| `n` | `integer` | `1`，范围 `1 ~ 10` | 生成的图像数量 |
| `response_format` | `enum` | `url` | 图像结果的返回方式 |

### 速率限制

| 分组 | RPM | TPM | RPD |
|---|---:|---:|---:|
| Gpt Image | 70 | — | 1.2K |

---

## gpt-image-2-4K

### 调用示例

```bash
curl https://api.slomerex.xyz/v1/chat/completions \
  -H "Authorization: Bearer $NEW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-4K",
    "messages": [
      {
        "role": "user",
        "content": "Explain quantum entanglement in one paragraph."
      }
    ],
    "temperature": 0.7
  }'
```

### 支持的参数

| 参数 | 类型 | 默认值 / 范围 | 说明 |
|---|---|---|---|
| `prompt` | `string` | 必填 | 想要生成图像的文字描述 |
| `size` | `enum` | `1024x1024` | 输出图像尺寸 |
| `quality` | `enum` | `standard` | 生成质量预设 |
| `style` | `enum` | `vivid` | 画风 |
| `n` | `integer` | `1`，范围 `1 ~ 10` | 生成的图像数量 |
| `response_format` | `enum` | `url` | 图像结果的返回方式 |

### 速率限制

| 分组 | RPM | TPM | RPD |
|---|---:|---:|---:|
| Gpt Image | 60 | — | 900 |

---

## grok-imagine-image-lite

### 调用示例

```python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.slomerex.xyz/v1",
    api_key="<YOUR_API_KEY>",
)

completion = client.chat.completions.create(
    model="grok-imagine-image-lite",
    messages=[
        {"role": "user", "content": "Explain quantum entanglement in one paragraph."}
    ],
)

print(completion.choices[0].message.content)
```

### 支持的参数

| 参数 | 类型 | 默认值 / 范围 | 说明 |
|---|---|---|---|
| `prompt` | `string` | 必填 | 想要生成图像的文字描述 |
| `size` | `enum` | `1024x1024` | 输出图像尺寸 |
| `quality` | `enum` | `standard` | 生成质量预设 |
| `style` | `enum` | `vivid` | 画风 |
| `n` | `integer` | `1`，范围 `1 ~ 10` | 生成的图像数量 |
| `response_format` | `enum` | `url` | 图像结果的返回方式 |

### 速率限制

| 分组 | RPM | TPM | RPD |
|---|---:|---:|---:|
| Grok | 40 | — | 700 |

---

## 速率限制说明

- **RPM**：每分钟请求数（Requests Per Minute）
- **TPM**：每分钟 token 数（Tokens Per Minute）
- **RPD**：每日请求数（Requests Per Day）
- 限制按令牌分组生效。