指南
快速开始

快速开始

本文将对使用FloxAI调用模型的方法进行一个概览, 让你能以最快的速度使用起来

账号注册

  1. 访问登录页面 (opens in a new tab), 选择创建账户
  2. 点击注册, 将会发送验证到你的邮箱
  3. 输入验证码后点击注册即可

账号是使用FloxAI的基础, 所有资源都关联到你的账户下, 请妥善设置安全密码和保管账号

创建令牌

注册好帐号后,前往 令牌管理 页面创建一个新的 API 密钥。请妥善保存此密钥,因为它将用于身份验证。详细步骤,请查看 令牌说明

获取到令牌后,您需要将下面的代码中的 <your-api-key> 替换为您的实际 API 密钥。

请妥善保管 api-key , api-key 是验证你身份的唯一标识, 不要将其存储在前端或者别人可以拿到的地方


选择模型

我们支持多种模型,您可以在 模型列表 中查看可用模型。选择适合您需求的模型。


调用说明

详细调用说明,请参考 调用说明

OpenAI API 请求

OpenAI API 兼容 OpenAI 的 API 接口,您可以使用 OpenAI 的 SDK 来调用我们的模型。

通过 API URL 调用

curl "https://api.floxai.io/v1/chat/completions" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <your-floxai-api-key>" \
    -d '{
        "model": "gpt-4o-mini",
        "messages": [
            {
                "role": "user",
                "content": "Say hello to FloxAI."
            }
        ]
    }'

通过 SDK 调用

更多的 SDK 使用示例,请参考 OpenAI SDK 文档 (opens in a new tab)

Python

from openai import OpenAI
 
client = OpenAI(
    api_key="<your-api-key>",
    base_url="https://api.floxai.io/v1"
)
 
completion = client.chat.completions.create(
    model="gpt-4.1",
    messages=[
        {
            "role": "user",
            "content": "Say hello to FloxAI."
        }
    ]
)
 
print(completion.choices[0].message.content)

Claude API 请求

Claude API 兼容 Anthropic 的 API 接口,您可以使用 Anthropic 的 SDK 来调用我们的模型。

通过 API URL 调用

curl -X POST https://api.floxai.io/v1/messages \
    -H "Content-Type: application/json" \
    -H "x-api-key: <your-floxai-api-key>" \
    -d '{
        "model": "claude-opus-4-20250514",
        "messages": [
            {
                "role": "user",
                "content": "Say hello to FloxAI."
            }
        ]
    }'

通过 SDK 调用

更多 SDK 使用示例,请参考 Claude SDK 文档 (opens in a new tab)

Python

import anthropic
 
client = anthropic.Anthropic(
    api_key="<your-floxai-api-key>",
    base_url="https://api.floxai.io"
)
 
message = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1000,
    temperature=1,
    system="You are teacher",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Say hello to FloxAI."
                }
            ]
        }
    ]
)
 
print(message.content)

Gemini API 请求

Gemini API 兼容 Google 的 API 接口,您可以使用 Google 的 SDK 来调用我们的模型。

通过 API URL 调用

curl -X POST 'https://api.floxai.io/v1/models/gemini-2.5-flash:generateContent' \
  --header 'Content-Type: application/json' \
  --header 'x-goog-api-key: <your-floxai-api-key>' \
  --data-raw '{
    "contents": [
      {
        "parts": [
          {
            "text": "Say hello to FloxAI."
          }
        ],
        "role": "user"
      }
    ]
  }'

通过 SDK 调用

更多 SDK 使用示例,请参考 Gemini SDK 文档 (opens in a new tab)

Python

from google import genai
from google.genai import types
 
prompt = "Explain the Occam's Razor concept and provide everyday examples of it"
budget = 1024  # You can set this variable to any value between 0 and 24k
 
client = genai.Client(
    http_options=types.HttpOptions(base_url='https://api.floxai.io'),
    api_key="<your-floxai-api-key>",
)
 
response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents=prompt,
    config=types.GenerateContentConfig(
        thinking_config=types.ThinkingConfig(
            thinking_budget=budget,
            include_thoughts=True
        )
    ),
)
 
print(response.text)