API 接入文档

欢迎查阅 Fugu Ultra API 接入文档。本平台提供标准的 HTTP API 接口，用于访问 Fugu Ultra 模型能力。

快速开始

要使用我们的 API，请将你的客户端 Base URL 配置为以下地址：

• 生产环境：https://fuguultra.net/api/v1

目前支持以下标准的 HTTP 接口：

• GET /models：获取可用模型列表。
• POST /chat/completions：生成对话回复。
• POST /responses：Responses 接口。

支持的模型：

• fugu-ultra
• fugu-ultra-20260615

创建 API Key

API 使用标准的 Bearer Token 进行认证。你可以在后台 Settings > API Keys 页面创建你的 API Key。

在发起请求时，请在 HTTP 头的 Authorization 字段中带上你的 API Key：

Authorization: Bearer <你的 API Key>

发起第一个 HTTP 请求

你可以使用任何能够发送 HTTPS 请求的客户端来调用 API。以下是获取模型列表的示例：

cURL:

curl https://fuguultra.net/api/v1/models \
  -H "Authorization: Bearer 你的_API_KEY"

JavaScript (fetch):

const response = await fetch("https://fuguultra.net/api/v1/models", {
  headers: {
    "Authorization": "Bearer 你的_API_KEY"
  }
});
const data = await response.json();
console.log(data);

Python (requests):

import requests

response = requests.get(
    "https://fuguultra.net/api/v1/models",
    headers={"Authorization": "Bearer 你的_API_KEY"}
)
print(response.json())

使用对话生成接口

生成对话回复。

cURL:

curl https://fuguultra.net/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的_API_KEY" \
  -d '{
    "model": "fugu-ultra",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

JavaScript (fetch):

const response = await fetch("https://fuguultra.net/api/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer 你的_API_KEY"
  },
  body: JSON.stringify({
    model: "fugu-ultra",
    messages: [{ role: "user", content: "你好！" }]
  })
});
const data = await response.json();
console.log(data.choices[0].message);

Python (requests):

import requests

response = requests.post(
    "https://fuguultra.net/api/v1/chat/completions",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer 你的_API_KEY"
    },
    json={
        "model": "fugu-ultra",
        "messages": [{"role": "user", "content": "你好！"}]
    }
)
print(response.json()["choices"][0]["message"])

使用 Responses 接口

cURL:

curl https://fuguultra.net/api/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的_API_KEY" \
  -d '{
    "model": "fugu-ultra",
    "input": "你好！"
  }'

查看用量日志

平台使用 Credits (积分) 进行计费。你可以在 Settings > API Usage 查看消耗明细，在 Settings > Billing 购买额度。

额度如何计算

Credits 是 API 调用的用量单位，实际消耗取决于 token 用量、缓存上下文、编排消耗和上下文长度。

额度计费标准

标准上下文：

• 输入 tokens：6,000 credits / 100 万 tokens
• 输出 tokens：36,000 credits / 100 万 tokens
• 缓存输入 tokens：600 credits / 100 万 tokens

超过 272K 的长上下文：

• 输入 tokens：12,000 credits / 100 万 tokens
• 输出 tokens：54,000 credits / 100 万 tokens
• 缓存输入 tokens：1,200 credits / 100 万 tokens

Fugu Ultra 可能会产生用于规划、路由、验证和合成结果的编排 tokens。这部分 tokens 会按照相同的输入、输出和缓存输入标准计入额度消耗。

最终消耗会向上取整到整数 credits。你可以在 API Usage 中查看每次请求的用量明细。

常见错误代码

如果请求失败，你可能会遇到以下错误代码：

• invalid_api_key：提供的 API Key 无效或已被撤销。
• invalid_method：当前接口不支持该 HTTP 方法。
• invalid_request_error：请求体无效或缺少必要字段。
• insufficient_quota：你的账户余额不足，无法完成本次请求。
• model_not_found：请求的模型不受支持。
• proxy_disabled：服务暂时不可用，请稍后重试或联系支持。
• api_error：请求处理失败，请稍后重试。