API 鉴权

所有 Get3W API 请求都需要使用 API Key 进行鉴权。

工作方式

把 API Key 以 Bearer token 的形式放在 Authorization 请求头里：

Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API Key 以 sk_ 开头。所有 /v1/ 接口的请求都必须带上这个头。

获取 API Key

打开 API Keys
填写名称并点击 Generate
复制并妥善保存 —— 完整的 Key 只会展示一次

提示

新建的 Key 立即可用。真正的限制来自余额而不是 Key：每次请求在执行前都会计价并校验，所以收到 402 说明需要充值，而不是 Key 未生效。

代码示例

cURLPythonJavaScript

bash

curl -X POST "https://api.get3w.com/v1/google/nano-banana-pro/text-to-image?sync=true" \
  -H "Authorization: Bearer $GET3W_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A cat in space", "channel": "stable"}'

python

import os
import requests

api_key = os.environ.get("GET3W_API_KEY")

response = requests.post(
    "https://api.get3w.com/v1/google/nano-banana-pro/text-to-image?sync=true",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json={"prompt": "A cat in space", "channel": "stable"}
)

javascript

const apiKey = process.env.GET3W_API_KEY;

fetch("https://api.get3w.com/v1/google/nano-banana-pro/text-to-image?sync=true", {
    method: "POST",
    headers: {
        "Authorization": `Bearer ${apiKey}`,
        "Content-Type": "application/json"
    },
    body: JSON.stringify({ prompt: "A cat in space", channel: "stable" })
})
.then(res => res.json())
.then(data => console.log(data));

管理 API Key

在 get3w.com/api-keys 管理你的 Key：

创建 —— 为不同项目生成不同的 Key（每个账户最多 10 个有效 Key）
删除 —— 移除不再需要的 Key

删除后的 Key 会立即失效。

安全最佳实践

做法	原因
使用环境变量	不要把 API Key 硬编码进源码
保密 Key	不要提交到 Git，也不要公开分享
只在服务端使用	绝不要在前端/浏览器代码中暴露 Key
分项目使用不同 Key	为不同项目创建不同的 Key

设置环境变量

Linux / macOSWindows PowerShellWindows CMD

bash

export GET3W_API_KEY="sk_your-api-key"

powershell

$env:GET3W_API_KEY="sk_your-api-key"

cmd

set GET3W_API_KEY=sk_your-api-key

账户等级

等级根据累计充值金额自动计算，并解锁按模型的价格折扣：

等级	门槛
Bronze	默认
Silver	$100+
Gold	$1,000+
Platinum	$10,000+

等级只升不降。详见什么是账户等级。

错误码

所有错误都返回 {"code": <http_status>, "error": "<message>"}。完整说明见错误码。

错误码	错误	原因
`401`	Missing Authorization header	请求中没有 `Authorization` 头
`401`	Invalid Authorization format	头格式不是 `Bearer <api_key>`
`401`	Invalid or revoked API key	Key 不存在或已被删除
`402`	Insufficient balance	余额低于任务预估费用 —— 充值后可继续
`403`	Account suspended	该 Key 关联的账户已被停用

常见问题

API Key 用不了？

确认 Key 以 sk_ 开头
确认头格式严格为 Authorization: Bearer sk_...
检查复制 Key 时是否带入了多余空格或换行
在 get3w.com/api-keys 确认 Key 未被删除
如果返回的是 402 而不是 401，说明 Key 没问题 —— 是账户余额不够跑这个任务

收到 402 Insufficient balance？

每个任务在执行前都会计价，余额不足则被拒绝。视频和数字人任务的费用远高于图像，所以够跑图像的余额未必够跑视频。可以用 GET /v1/balance 查询余额。

下一步

API 入门 — 完成第一次 API 调用
异步模式 — 提交任务后轮询结果
Webhook 模式 — 通过回调接收结果

API 鉴权 ​

工作方式 ​

获取 API Key ​

代码示例 ​

管理 API Key ​

安全最佳实践 ​

设置环境变量 ​

账户等级 ​

错误码 ​

常见问题 ​

下一步 ​