Photta API

Photta API 基于 REST 的虚拟 try-on、隐形模特与商品摄影服务

一句话总结

Photta API 是一套基于 credits 计费的 REST API：向 capability endpoint 发起 POST 请求提交商品图，每隔数秒轮询 (poll) 其状态 endpoint，下载最终生成的图片。八项 capability，一个 key，统一扣除 credit 余额。

获取 API Key 阅读文档

功能列表: 8 项功能
速率限制: 600 次请求/分钟
认证: Bearer key
设计模式: 异步，轮询

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

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_type": "top",
  "product_images": [
    "https://cdn.yourstore.com/products/shirt-front.jpg"
  ],
  "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
  "product_category": "t_shirt",
  "mannequin_id": "mnk_f3a9b1",
  "pose_id": "pose_c2d4e5",
  "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
  "lock_background": true,
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "body_size": "M",
  "expression": "neutral",
  "user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/tryon/apparel", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "product_type": "top",
    "product_images": [
      "https://cdn.yourstore.com/products/shirt-front.jpg"
    ],
    "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
    "product_category": "t_shirt",
    "mannequin_id": "mnk_f3a9b1",
    "pose_id": "pose_c2d4e5",
    "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
    "lock_background": true,
    "resolution": "2K",
    "aspect_ratio": "3:4",
    "body_size": "M",
    "expression": "neutral",
    "user_instruction": "Keep the collar pattern crisp and centered."
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/tryon/apparel",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "product_type": "top",
      "product_images": [
        "https://cdn.yourstore.com/products/shirt-front.jpg"
      ],
      "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
      "product_category": "t_shirt",
      "mannequin_id": "mnk_f3a9b1",
      "pose_id": "pose_c2d4e5",
      "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
      "lock_background": True,
      "resolution": "2K",
      "aspect_ratio": "3:4",
      "body_size": "M",
      "expression": "neutral",
      "user_instruction": "Keep the collar pattern crisp and centered."
    },
)
data = res.json()["data"]  # data["id"], data["status"]

功能列表

按 capability 划分的所有 endpoint

请求方法、路径、credits 消耗以及典型耗时，均直接取自 API 文档。本页数据已于底部所示日期对照官方文档核对确认。

语言

尚无 SDK —— 但你其实并不需要。

三套即拷即用的实操代码，完全遵循 Photta 官方文档当前的推荐做法。

快速入门

从注册到生成首张图片，只需五分钟。

所有 capability 均遵循相同模式：鉴权、提交、轮询 (poll)。一次掌握，处处通用。

步骤 1: 在 ai.photta.app 注册，并在开发者控制台中生成一个正式 API key。
步骤 2: 发起 POST 请求提交任务，并在 Authorization 请求头中附带你的 key —— API 会立即返回一个 generation ID。
步骤 3: 每隔 3 秒轮询 (poll) 同一 endpoint，直到状态变为 completed，然后下载输出的 URL 结果。

快速开始

常见问题

开发者在注册前通常会问的问题

什么是 Photta API？

Photta API 是一项基于 credits 计费的 REST 服务，可根据你的商品图生成专业级时尚摄影大片。它与驱动 Photta 消费端应用（虚拟服装 try-on、珠宝 try-on 以及隐形模特图提取）采用完全相同的底层管线，并以八种 capability 的形式开放给开发者构建自己的工具。

如何获取 API key？

在 ai.photta.app 注册，打开控制台的开发者板块，点击生成 API key。你的正式 key 以 `photta_live_` 开头，后接 32 位十六进制字符。请将其保存在环境变量中 —— 切勿提交至源码仓库，切勿暴露给浏览器端。

是否有免费额度？

新账号可获赠测试 credits，可用于调用任意 capability。准备好上线时，可订阅包含更高月度 credit 额度的方案。所有方案的 rate limit 完全一致：每个 API key 每分钟 600 次请求。无单次调用最低消费门槛。

生成速度有多快？

Try-on 与隐形模特任务通常在 1.5 到 4 分钟内完成；眼镜特写、细节特写和工作流图片需 20 到 60 秒；模特生成需 30 到 60 秒。所有生成 endpoint 均为异步模式：POST 请求会立即返回 generation ID，随后你只需每隔 3 到 5 秒轮询 (poll) 一次直到任务完成。无需维护长连接 HTTP 连接。

是否有官方的 Photta SDK？

暂时没有。目前支持的接入方式是原生 REST，可通过 cURL、Node 原生 fetch 或 Python 的 requests 库进行调用 —— 本站针对每种 capability 都提供了这三种方式的端到端完整文档。

参考文档

文档中你可能会多次查阅的内容。

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

五分钟内上手试用 API

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

获取 API Key 快速开始

8 项功能
600 次请求/分钟
Bearer key
异步，轮询