快速开始

本页帮你用 OpenAI 兼容格式发出第一条 AGICTO API 请求。完成后，你会知道 API Key 放在哪里、Base URL 怎么写，以及如何验证响应是否成功。

前置条件

你已经有 AGICTO API 的 API Key
你的账户有可用余额或额度
你的运行环境可以访问 AGICTO API

如果你只是想快速验证连通性，先使用 Chat completions。它最适合作为第一次调用。

1. 设置 API Key

调用接口时，将 API Key 放在 Authorization Header 中。

Authorization: Bearer $API_KEY

不要在客户端代码、公开仓库或日志中暴露 API Key。

2. 使用 Base URL

AGICTO API 的 Base URL 是：

https://api.agicto.cn/v1/

直接复制控制台里显示的 Base URL。示例请求会使用完整地址。本页使用 Chat completions，完整请求地址是：

https://api.agicto.cn/v1/chat/completions

3. 发送第一条 Chat 请求

复制下面的命令，将 $API_KEY 替换为你的 API Key，将 model 替换为你账户可用的模型名。

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": "你好，请用一句话介绍 AGICTO API。"
      }
    ]
  }'

成功时，接口会返回模型生成的消息。失败时，先检查 API Key、余额、模型名和请求 JSON。

4. 使用 OpenAI SDK

如果你已经在项目中使用 OpenAI SDK，可以把客户端的 Base URL 改为控制台显示的 Base URL。

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AGICTO_API_KEY,
  baseURL: "https://api.agicto.cn/v1/"
});

const completion = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [
    {
      role: "user",
      content: "你好，请用一句话介绍 AGICTO API。"
    }
  ]
});

console.log(completion.choices[0].message.content);

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AGICTO_API_KEY"],
    base_url="https://api.agicto.cn/v1/",
)

completion = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {
            "role": "user",
            "content": "你好，请用一句话介绍 AGICTO API。",
        }
    ],
)

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

5. 下一步

模型与价格

查看模型类型、价格字段和模型名复制方式。

OpenAI 兼容格式

查看聊天、嵌入、图片和视频的迁移方式。

账户余额

调用余额接口，确认账户可用额度。

API reference

查看完整接口列表和 Apifox 同步示例。

流式输出

让聊天应用边生成边显示。

故障排查

按错误现象定位 API Key、余额、限速和模型问题。

开始使用

模型与价格

按场景接入

应用集成

AI 编程工具

前置条件

1. 设置 API Key

2. 使用 Base URL

3. 发送第一条 Chat 请求

4. 使用 OpenAI SDK

5. 下一步

模型与价格

OpenAI 兼容格式

账户余额

API reference

流式输出

故障排查

​前置条件

​1. 设置 API Key

​2. 使用 Base URL

​3. 发送第一条 Chat 请求

​4. 使用 OpenAI SDK

​5. 下一步

模型与价格

OpenAI 兼容格式

账户余额

API reference

流式输出

故障排查

前置条件

1. 设置 API Key

2. 使用 Base URL

3. 发送第一条 Chat 请求

4. 使用 OpenAI SDK

5. 下一步