参考 · 身份验证

Photta API 身份验证一个密钥，一个请求头

一句话总结

在每次发起 Photta API 调用时，通过 `Authorization: Bearer photta_live_xxx` 传递密钥。密钥在控制台中创建，无单 endpoint scope 限制，并共享同一个 credits 余额。

获取 API Key 阅读文档

身份验证: Bearer key
限制: 600 次请求/分钟
处理方式: 异步，轮询

本页所有数据均来自 Photta API 文档 · 已验证 2026-09-10

API 的预期输入

身份验证概览

Header: Authorization: Bearer photta_live_xxx
密钥前缀: photta_live_
Base URL: https://api.photta.app/api/v1
密钥创建位置: https://ai.photta.app
Scope: 单个密钥即可访问所有 endpoint 并共享同一个 credits 余额

单次调用校验密钥

账户 endpoint 完全免费，是验证密钥是否有效的安全方式。

curl https://api.photta.app/api/v1/account \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/account", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

密钥管理

疑似泄露立即轮换
文档明确说明：若怀疑密钥泄露，应立即进行轮换。先生成新密钥并完成部署，然后再停用旧密钥。
仅在服务端保存
密钥一旦暴露给浏览器，所有打开页面的用户都能获取。请务必从后端调用 API 并将结果传递给客户端。
401 指向密钥本身，而非请求内容
密钥缺失、无效或过期将返回 `authentication_error`。在排查其他问题之前，请先检查请求头中是否存在拼写错误或多余的空格。
所有密钥共享同一余额
密钥不按功能划分 scope。即使为不同环境配置了多个密钥，它们消耗的仍是同一个 credits 余额，可通过 GET `/api/v1/account` 查询。

身份验证常见问题

如何对请求进行身份验证？

在每次调用的 Authorization 请求头中，将密钥作为 Bearer 令牌发送。无需单独的登录或令牌交换步骤。

我在哪里创建密钥？

在你的 Photta 控制面板中。该页面也可以换发新密钥，这也是文档在返回 401 后指引你前往的地方。

我可以在浏览器中调用该 API 吗？

不能直接使用你的密钥调用。任何推送到浏览器的内容都可以被访问者读取，因此请将调用置于你自己的服务器之后，并转发结果。

如果密钥泄露了怎么办？

立即轮换密钥——生成一个新密钥，部署它，然后删除旧密钥。已消耗的 credits 无法找回，所以先轮换密钥，事后再排查原因。

Endpoint 与参考

本页所有数据均来自 Photta API 文档 · 已验证 2026-09-10

五分钟内上手试用 API

生成 Photta API key，粘贴上方的 cURL 代码片段，咖啡还没煮好，你的第一张模特实穿图就已经生成完毕。

创建账户并获取 API Key API

Bearer key
600 次请求/分钟
异步，轮询

Photta API 身份验证 一个密钥，一个请求头