认证 - APIXO

所有 APIXO API 请求都需要使用 Bearer 令牌进行认证。

获取 API 密钥

创建账户

如尚未注册，请前往 apixo.ai 注册。

进入控制台

打开 Dashboard → API Keys。

生成密钥

点击 Create New Key，为其命名，并立即复制密钥。

API 密钥仅显示一次，请妥善保存。

使用 API 密钥

在每个请求的 Authorization 请求头中携带你的 API 密钥：

Authorization: Bearer YOUR_API_KEY

cURL
JavaScript
Python

curl -X POST https://api.apixo.ai/api/v1/generateTask/nano-banana \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"request_type": "async", "input": {"prompt": "A sunset"}}'

const response = await fetch('https://api.apixo.ai/api/v1/generateTask/nano-banana', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    request_type: 'async',
    input: { prompt: 'A sunset' }
  }),
});

const data = await response.json();
console.log(data.data.taskId);

import requests

response = requests.post(
    'https://api.apixo.ai/api/v1/generateTask/nano-banana',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'request_type': 'async',
        'input': {'prompt': 'A sunset'}
    }
)

data = response.json()
print(data['data']['taskId'])

安全最佳实践

Never expose keys in client-side code

API 密钥应仅在服务端应用中使用

Use environment variables

将密钥存放在 .env 文件中，切勿提交到 git

Rotate keys regularly

定期创建新密钥并撤销旧密钥

Set up IP allowlists

在控制台中限制密钥仅可在特定 IP 地址使用

错误响应

认证失败时，你会收到：

{
  "code": 401,
  "message": "Invalid or missing API key"
}

常见原因：

缺少 Authorization 请求头
API 密钥无效或已被撤销
密钥对该模型没有权限

下一步

完成认证后，可参考快速入门指南生成你的第一张图片。

快速开始

核心概念

API 参考

模型

指南

认证

获取 API 密钥

创建账户

进入控制台

生成密钥

使用 API 密钥

安全最佳实践

Never expose keys in client-side code

Use environment variables

Rotate keys regularly

Set up IP allowlists

错误响应

下一步

快速开始

核心概念

API 参考

模型

指南

​获取 API 密钥

​创建账户

​进入控制台

​生成密钥

​使用 API 密钥

​安全最佳实践

Never expose keys in client-side code

Use environment variables

Rotate keys regularly

Set up IP allowlists

​错误响应

​下一步

获取 API 密钥

创建账户

进入控制台

生成密钥

使用 API 密钥

安全最佳实践

错误响应

下一步