Jack 1 month ago
parent a30b0ae532
commit f3d3e02341
  1. 12
      SKILL.md
  2. 191
      docs.md

@ -7,11 +7,7 @@ description: Generate images via AI text-to-image API (GPT Image / Grok). Use wh
通过 FastAPI 文生图服务生成图片,供 Agent 通过 HTTP/cURL 直接调用,无需自己实现模型请求逻辑。
服务端使用 OpenAI Python SDK 请求 GPT Image / Grok Image 上游接口,生成的图片保存在服务端 `output/` 目录,并通过 HTTP 返回访问地址。
- 服务端 API 不要求调用方提供上游 API Key;上游鉴权通过项目根目录 `.env` 配置
- `.env` 不应提交到 Git,复制 `.env.example``.env` 后填写真实 Key
- 使用 Docker Compose 时会自动读取 `.env` 并注入容器
服务端使用 OpenAI Python SDK 请求 GPT Image / Grok Image 上游接口,生成的图片保存在服务端 `output/<profile_name>/` 目录,并通过 HTTP 返回访问地址。
## 可用脚本
@ -33,12 +29,6 @@ description: Generate images via AI text-to-image API (GPT Image / Grok). Use wh
## 使用方式
先启动 FastAPI 服务:
```bash
uvicorn agent-image-t2i:app --host 0.0.0.0 --port 8765
```
默认服务地址为 `http://localhost:8765`
健康检查:

@ -1,191 +0,0 @@
# 图像模型 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)
- 限制按令牌分组生效。
Loading…
Cancel
Save