機能 · ディテール写真
商品ディテール写真API クローズアップ用
要約
Phottaのディテール写真APIは、指定された商品の一領域のクローズアップをレンダリングします。無料の analyze 呼び出しで撮影価値のあるディテールを提案。generate 呼び出しは解像度ティアなしの一律3 creditsです。
- 所要時間の目安: 20–60 sec
- Credits: 3 credits
- 処理方式: 非同期、ポーリング
- 制限: 600 リクエスト/分
- 認証: Bearerキー
このページに記載されている数値はすべて以下に基づきます: Photta APIドキュメント · 確認済み
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/detail-photos \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_image": "https://cdn.yourstore.com/products/linen-shirt-hero.jpg",
"detail_label": "collar stitching",
"detail_description": "Focus on the reinforced double-stitch seam along the collar edge.",
"framing": "extreme-closeup",
"source_type": "apparel"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/detail-photos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"product_image": "https://cdn.yourstore.com/products/linen-shirt-hero.jpg",
"detail_label": "collar stitching",
"detail_description": "Focus on the reinforced double-stitch seam along the collar edge.",
"framing": "extreme-closeup",
"source_type": "apparel"
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/detail-photos",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"product_image": "https://cdn.yourstore.com/products/linen-shirt-hero.jpg",
"detail_label": "collar stitching",
"detail_description": "Focus on the reinforced double-stitch seam along the collar edge.",
"framing": "extreme-closeup",
"source_type": "apparel"
},
)
data = res.json()["data"] # data["id"], data["status"]概要
概要
- エンドポイント
- POST /api/v1/detail-photos
- 認証
- Bearer APIキー
- 処理方式
- 非同期 — ステータスエンドポイントをポーリング
- 所要時間の目安
- 20–60 sec
- Credits
- 3 credits
- 入力制限
- 1画像あたり最大10 MB、JPEG, PNG, WebP
- 冪等性
- なし
リクエストとレスポンス
リクエスト
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/detail-photos \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_image": "https://cdn.yourstore.com/products/linen-shirt-hero.jpg",
"detail_label": "collar stitching",
"detail_description": "Focus on the reinforced double-stitch seam along the collar edge.",
"framing": "extreme-closeup",
"source_type": "apparel"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/detail-photos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"product_image": "https://cdn.yourstore.com/products/linen-shirt-hero.jpg",
"detail_label": "collar stitching",
"detail_description": "Focus on the reinforced double-stitch seam along the collar edge.",
"framing": "extreme-closeup",
"source_type": "apparel"
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/detail-photos",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"product_image": "https://cdn.yourstore.com/products/linen-shirt-hero.jpg",
"detail_label": "collar stitching",
"detail_description": "Focus on the reinforced double-stitch seam along the collar edge.",
"framing": "extreme-closeup",
"source_type": "apparel"
},
)
data = res.json()["data"] # data["id"], data["status"]202 Accepted / Completed
{
"data": {
"id": "dtl_9f2c4a71b8e3d605a1f7c2948d3b6e10",
"status": "processing",
"detail_label": "collar stitching",
"framing": "extreme-closeup",
"credits_used": 3,
"created_at": "2026-07-30T14:20:00Z"
},
"request_id": "req_dtl001"
}{
"data": {
"id": "dtl_9f2c4a71b8e3d605a1f7c2948d3b6e10",
"status": "completed",
"detail_label": "collar stitching",
"framing": "extreme-closeup",
"output_url": "https://cdn.photta.app/generated/dtl_9f2c4a71b8e3d605a1f7c2948d3b6e10.jpg",
"thumbnail_url": "https://cdn.photta.app/generated/dtl_9f2c4a71b8e3d605a1f7c2948d3b6e10-thumb.jpg",
"credits_used": 3,
"created_at": "2026-07-30T14:20:00Z",
"completed_at": "2026-07-30T14:20:42Z",
"duration_ms": 42000
},
"request_id": "req_dtl003"
}リクエストパラメータ
product_image型: string必須
The source image — a completed generation's output_url or any product photo. https URL or base64 data URI. JPEG, PNG, WebP; max 10 MB.
detail_label型: string必須
The area to zoom into, e.g. "collar stitching", "cuff detail", "fabric weave on the chest", "pendant clasp". Max 100 characters.
detail_description型: string
Extra guidance for the close-up. Max 400 characters.
framing型: string
How tight the crop is: "extreme-closeup" — the detail fills ~90% of the frame (near-macro); "closeup" — ~70% with some surrounding context; "medium-closeup" — ~50% with body/outfit visible.
= medium-closeup
値:extreme-closeupcloseupmedium-closeupsource_type型: string
Tunes what is preserved in the close-up.
= apparel
値:appareljewelry
エラー
- 400
invalid_request_error - The request is malformed or contains invalid parameters.
- 401
authentication_error - The API key is missing, invalid, or expired.
- 402
insufficient_credits_error - Your account does not have enough credits.
- 404
not_found_error - The requested resource does not exist.
- 409
conflict_error - The request conflicts with current state — e.g. your concurrent-batch cap is reached.
- 429
rate_limit_error - Too many requests. Slow down and retry.Retry-After: 30
- 500
api_error - An internal server error occurred. Retry later.
制限
- APIキーごとに毎分600リクエスト (固定ウィンドウ方式。制限値はすべてのプランで共通です)
- 429にはRetry-After: 30 secondsが含まれます
- 1画像あたり最大10 MB
- フォーマット: JPEG, PNG, WebP
- プランごとの同時実行バッチ数: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- ポーリングのみ — APIはWebhookを送信しません。
撮影価値のあるディテールを問い合わせてから撮影
無料で分析し、ディテールを選択、送信、ポーリング、ダウンロード。
ステップ 1
APIキーを生成
ディテール写真は、他のすべてのPhotta機能と同じ認証情報と同じcredit残高を使用します。
ステップ 2
撮影すべきディテールを問い合わせる
`product_image` を指定して POST `/api/v1/detail-photos/analyze` を実行します。該当商品に対する推奨の `detail_label`、`detail_description`、`framing` の値が同期的に返され、料金は一切かかりません。
ステップ 3
クローズアップをPOST送信
`product_image` と `detail_label` を指定して POST `/api/v1/detail-photos` を実行します。`framing` には `extreme-closeup`、`closeup`、`medium-closeup` のいずれかを設定し、`source_type` には `apparel` または `jewelry` を指定、最大400文字の `detail_description` を追加します。
ステップ 4
ジョブが完了するまでポーリング
`data.status` が `completed` または `failed` になるまで、3秒ごとに GET `/api/v1/detail-photos/:id` を実行します。通常20〜60秒で完了します。
ステップ 5
ダウンロードと永続化
完了時のレスポンスボディに `output_url` が含まれます。ディテール写真は、PDPギャラリーのメイン写真の隣にそのまま配置できます。
Node.js、Python、cURLでの同一endpointの呼び出し
Node.js
Node.jsでの商品ディテール写真API
ネイティブのfetchを使用してNode.jsバックエンドからPhottaの商品ディテール写真APIを呼び出します。SDKは不要です。キーを保存し、ジョブを送信して、結果をポーリングするだけです。
読むPython
Python での 商品ディテール写真API
requests ライブラリを使用して Python で Photta の 商品ディテール写真API を呼び出します。30行のラッパーで、httpx による非同期対応も可能であり、Django、FastAPI、Celery で動作します。
読むcURL
cURLによる商品ディテール写真API
cURLを使用してシェルから直接Phottaの商品ディテール写真APIを呼び出します。送信、ポーリング、ダウンロード — すべてのスニペットはスクリプトパイプライン向けにjqと連携可能です。
読む
ディテール写真の本番導入前に開発者が確認する質問
ディテール写真APIとは何ですか?
マクロレンズを用いた2回目のスタジオ撮影を行う代わりに、1枚の広角写真から、襟のステッチ、留め具、胸元の織り目といった商品の指定領域のクローズアップをレンダリングするendpointです。
ディテール写真の料金はいくらですか?
一律3 creditsです。このendpointに解像度ティアはなく、ディテールを提案する analyze の呼び出しは無料です。
analyze endpointは何を返しますか?
提案のリストを返します。各項目には `detail_label`、その領域を見せるべき理由を説明する `detail_description`、推奨の `framing` が含まれます。任意の提案をそのまま generate 呼び出しに渡すことができます。
各 framing オプションの寄り具合はどのくらいですか?
`extreme-closeup` はフレームのほぼ全体をディテールで満たし、`closeup` はその周囲のコンテキストを少し残し、`medium-closeup` は周囲の衣服やアイテムの中にディテールを収めます。商品単位ではなく、ディテール単位で選択してください。
生成された画像をソースとして使用できますか?
はい。`product_image` には、生成完了時の `output_url` だけでなく、独自の商品写真を https URL または base64 データ URI として指定できます。
結果はどのようにポーリングすればよいですか?
`data.status` が `completed` または `failed` になるまで、3 秒ごとに GET `/api/v1/detail-photos/:id` を実行します。解析呼び出しは同期処理のため、ポーリングは不要です。
関連機能
機能一覧
バーチャルtry-on API アパレル向け
AIマネキンにアパレルを着せるREST API。非同期処理、生成時間は1.5〜4分、2Kで5クレジット、4Kで6クレジット。cURL、Node.js、Pythonのサンプルコードあり。
エンドポイントを見る機能一覧
ジュエリー try-on API ネックレス、リング、ブレスレット、イヤリングに対応
REST 経由でネックレス、指輪、ブレスレット、イヤリングを AI モデルに配置。2K で 5 credits、クローズアップマネキンを内蔵、Photta のドキュメントに基づく反射を考慮したレンダリング。
エンドポイントを見る実装
AI商品撮影サービスを構築する
Phottaのバーチャルtry-on APIをホワイトラベルSaaSとしてリセールするためのファウンダー向けプレイブック:テナントキー、バッチファンアウト、credit単位の請求、SLAの現実。
エンドポイントを見る比較
Photta vs FASHN — ファッションAI APIの徹底比較
PhottaとFASHNの比較:エンドポイント、クレジット料金、プラン階層、同時実行数上限。2026-04-19時点の各社公式価格設定ページから取得。加工された数値はありません。
エンドポイントを見るクイックスタート
5 分以内に最初の Photta 画像を生成。
サインアップ、API キーの生成、最初の cURL 呼び出しの実行、完了までのポーリング、結果の保存。エンドツーエンドで文書化された 5 つのステップ。
エンドポイントを見るリファレンス
Photta APIのエラー
ステータスコード別のPhotta APIエラータイプ一覧、エラーボディの構造、およびリトライすべき障害。
エンドポイントを見るリファレンス
Photta APIのレートリミット
Photta APIのレートリミット、ウィンドウ幅、Retry-Afterヘッダー、ポーリング間隔、プラン別の同時実行上限など、APIドキュメントに記載された仕様です。
エンドポイントを見る
このページに記載されている数値はすべて以下に基づきます: Photta APIドキュメント · 確認済み
5分でAPIを試す
Photta APIキーを生成し、上記のcURLスニペットを貼り付ければ、コーヒーが淹れ終わる前に最初のモデル着用画像が手に入ります。
- 20–60 sec
- 3 credits
- 非同期、ポーリング
- 600 リクエスト/分
- Bearerキー