跳转到主要内容
本页帮你用 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);

​
5. 下一步

模型与价格

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

OpenAI 兼容格式

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

账户余额

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

API reference

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

流式输出

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

故障排查

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