> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agicto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI 兼容格式

> 用 OpenAI SDK 和请求格式调用 AGICTO API

AGICTO API 支持 OpenAI 兼容格式。你可以复用现有 OpenAI SDK、请求体结构和多数调用流程，只需要把 Base URL、API Key 和模型名切换到 AGICTO API。

## 迁移清单

| 项目       | OpenAI                           | AGICTO API                       |
| -------- | -------------------------------- | -------------------------------- |
| Base URL | `https://api.openai.com/v1`      | `https://api.agicto.cn/v1/`      |
| API Key  | OpenAI API Key                   | AGICTO API Key                   |
| Header   | `Authorization: Bearer $API_KEY` | `Authorization: Bearer $API_KEY` |
| 请求格式     | OpenAI 格式                        | OpenAI 兼容格式                      |

<Tip>
  如果你的 SDK 支持自定义 `baseURL` 或 `base_url`，优先用 SDK 接入。这样可以保留已有的重试、类型和流式处理逻辑。
</Tip>

## Chat completions

使用 `/v1/chat/completions` 生成对话回复、摘要、翻译、分类和代码。

```bash theme={null}
curl https://api.agicto.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "请用三点总结这段文本。"
      }
    ]
  }'
```

查看接口细节：<a href="/api-reference/model/chat/message">Chat completions</a>

## Embeddings

使用 `/v1/embeddings` 将文本转换为向量。常见用途包括语义搜索、推荐、聚类和 RAG 检索。

```bash theme={null}
curl https://api.agicto.cn/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "text-embedding-ada-002",
    "input": "AGICTO API supports OpenAI-compatible requests.",
    "encoding_format": "float"
  }'
```

查看接口细节：<a href="/api-reference/model/embeddings/create">创建嵌入</a>

## Images

使用 `/v1/images/generations` 生成图片。你可以按模型能力传入 `prompt`、`size` 等参数。

```bash theme={null}
curl https://api.agicto.cn/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A clean product illustration for an API dashboard",
    "size": "1024x1024"
  }'
```

查看接口细节：<a href="/api-reference/images/openai/generate">图片生成</a>

## Videos

使用 `/v1/videos` 创建 OpenAI 兼容格式的视频任务。创建任务后，使用返回的 `id` 查询状态。

```bash theme={null}
curl https://api.agicto.cn/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=sora-2-vip" \
  -F "prompt=一只机械手臂在实验室中组装芯片，电影感镜头" \
  -F "seconds=8" \
  -F "size=1280x720"
```

查看接口细节：<a href="/guides/video-workflow">视频任务流程</a>

## 常见迁移问题

* 如果返回认证错误，确认 Header 是 `Authorization: Bearer $API_KEY`。
* 如果返回模型不可用，确认 `model` 是你账户支持的模型名。
* 如果 OpenAI SDK 报路径错误，确认 Base URL 是否包含 `/v1`。
* 如果请求图片或视频，确认你的请求格式是 JSON 还是 `multipart/form-data`。