Gem2a

如何使用中转 API

本服务提供一个兼容 OpenAI API 的中转接口，您可以使用任何支持 OpenAI API 的客户端（如 Chatbox、cURL、Python 库等）来访问。

API 端点

您的 API 端点是：[您的 Hugging Face Spaces URL]/v1/chat/completions

认证方式

请在请求头中包含您的 API Key。支持以下两种方式：

• X-API-Key: your_api_key_here
• Authorization: Bearer your_api_key_here

请求示例 (cURL)

curl -X POST "[您的 Hugging Face Spaces URL]/v1/chat/completions" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer your_admin_or_user_key" \
     -d '{
       "model": "gemini-2.5-flash",
       "messages": [
         {"role": "user", "content": "Hello, how are you?"}
       ]
     }'

请求示例 (Python - 使用 `requests` 库)

import requests

api_key = "your_admin_or_user_key"
url = "[您的 Hugging Face Spaces URL]/v1/chat/completions"

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {api_key}"
}

data = {
    "model": "gemini-2.5-flash",
    "messages": [
        {"role": "user", "content": "Hello, how are you?"}
    ]
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

请将 [您的 Hugging Face Spaces URL] 替换为您的实际服务地址，将 your_admin_or_user_key 替换为您在 Hugging Face Spaces 环境变量中配置的 API Key。