リファレンス · リソース

Photta API リソースエンドポイントすべての生成に必要なID群

要約

リソースエンドポイントは、生成コールに必要な各種ID（マネキン、ポーズ、背景、フットウェア、衣服の属性、ブランドラベル）に加え、アカウント残高や使用状況を返します。一覧取得に費用はかかりません。

APIキーを取得ドキュメントを見る

リソースエンドポイント: 13 件のリソースエンドポイント
認証: Bearerキー
制限: 600 リクエスト/分

このページに記載されている数値はすべて以下に基づきます: Photta APIドキュメント · 確認済み 2026-09-10

各リソースエンドポイントと取得用のAPIコール

各セクションには、取得したIDを使用する機能へのリンクが記載されています。

GET/api/v1/mannequins

マネキン

アパレルtry-onで利用可能なモデルを一覧表示します。Photta提供のシステムマネキン、独自にアップロードしたマネキン、マネキン生成APIで作成したマネキンが含まれます。同じパスにPOSTするとカスタムマネキンをアップロードでき、アカウント内でのみ非公開で保持されます。取得したIDは、try-onコールの `mannequin_id` に指定します。

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

const res = await fetch("https://api.photta.app/api/v1/mannequins", {
  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/mannequins",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

バーチャルtry-on API

POST/api/v1/mannequins/jewelry

ジュエリーマネキン

ジュエリーtry-on用のクローズアップモデル写真をアップロードします。ジュエリーの生成は首元、耳、手首、手などにフォーカスされるため、全身アパレル用とは異なる専用のマネキンセットを使用します。

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/mannequins/jewelry \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
  "jewelry_type": "necklace",
  "gender": "female",
  "name": "Emma"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/mannequins/jewelry", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
    "jewelry_type": "necklace",
    "gender": "female",
    "name": "Emma"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/mannequins/jewelry",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "image": "https://cdn.yourstore.com/models/emma-neck.jpg",
      "jewelry_type": "necklace",
      "gender": "female",
      "name": "Emma"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

ジュエリー try-on API

GET/api/v1/poses

ポーズ

try-onで指定可能なポーズを一覧表示します。カテゴリや適した製品タイプでフィルタリングが可能です。IDを `pose_id` として渡します。省略した場合は、衣服に最適なポーズがAPIによって自動選択されます。

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

const res = await fetch("https://api.photta.app/api/v1/poses", {
  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/poses",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

バーチャルtry-on API

GET/api/v1/garment-attributes

衣服の着丈とフィット感

アパレルtry-onで受け付け可能な着丈とフィット感のキーを返します。フリーテキストの説明ではなくキーを送信することで、カタログ全体で同一のシャツを一貫した形状でレンダリングできます。

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

const res = await fetch("https://api.photta.app/api/v1/garment-attributes", {
  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/garment-attributes",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

バーチャルtry-on API

GET/api/v1/backgrounds

背景

アパレルtry-on用のシステム背景および独自にアップロードした背景を、カーソルベースのページネーション付きで一覧表示します。同じパスにPOSTするとカスタム背景をアップロードでき、アカウント内でのみ非公開で保持されます。

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

const res = await fetch("https://api.photta.app/api/v1/backgrounds", {
  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/backgrounds",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

アイウェア仮想 try-on API

POST/api/v1/brand-labels

ブランドラベル

ゴーストマネキン処理で使用する再利用可能なラベル画像をアップロードし、単一ジョブやバッチ処理で `brand_label_id` として渡すIDを取得します。GETで保存済みラベルを一覧表示し、アカウントの上限に達した場合はDELETEで削除できます。

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/brand-labels \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "file": "@/path/to/pribrand-label.png",
  "name": "Pribrand Collar Label"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/brand-labels", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "file": "@/path/to/pribrand-label.png",
    "name": "Pribrand Collar Label"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/brand-labels",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "file": "@/path/to/pribrand-label.png",
      "name": "Pribrand Collar Label"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

ゴーストマネキン API

GET/api/v1/footwear

フットウェア

アパレルtry-on用のフットウェアオプションを、タイプや性別でフィルタリング可能なカーソルページネーション付きで一覧表示します。衣服を着用しているモデルに靴を履かせる場合に使用します。

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

const res = await fetch("https://api.photta.app/api/v1/footwear", {
  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/footwear",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

バーチャルtry-on API

GET/api/v1/account

アカウント

ソース別のクレジット残高の内訳、現在のプラン、次回のクレジット更新日時を返します。大規模なバッチ処理を実行する前に確認し、402エラーによる中断を防止してください。

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"]

Workflows API

GET/api/v1/account/usage

使用状況

当月（カレンダー月）の請求期間における生成回数と消費クレジットを、成功および失敗したジョブ別に分類して返します。独自のリクエスト集計ではなく、このエンドポイントの数値をグラフ化してください。

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

const res = await fetch("https://api.photta.app/api/v1/account/usage", {
  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/usage",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

バッチゴーストマネキン API

リソースエンドポイントに関するFAQ

リソースエンドポイントは何のためにありますか？

生成コールに必要なID（マネキン、ポーズ、背景、ブランドラベルなど）やアカウントの状態を返します。このグループのエンドポイント自体が画像を生成することはありません。

リソースの呼び出しにクレジットはかかりますか？

いいえ。一覧取得は無料であり、このグループでのアップロード（カスタムマネキン、背景、ブランドラベル）も無料です。費用が発生するのは生成処理のみです。

長いリストをページネーションで取得するにはどうすればよいですか？

一覧取得エンドポイントはlimitとcursorを受け取ります。直前に取得した最後のIDを `starting_after` に渡して次のページを読み込んでください。リクエストのたびに再取得するのではなく、取得した結果をキャッシュすることを推奨します。

独自のマネキンや背景をアップロードできますか？

はい。POST `/api/v1/mannequins`、POST `/api/v1/mannequins/jewelry`、POST `/api/v1/backgrounds`、POST `/api/v1/brand-labels` のすべてで独自画像のアップロードを受け付けており、アップロードされたアセットはお客様のアカウント内でのみ非公開で保持されます。

これらのIDの使用先

このページに記載されている数値はすべて以下に基づきます: Photta APIドキュメント · 確認済み 2026-09-10

5分でAPIを試す

Photta APIキーを生成し、上記のcURLスニペットを貼り付ければ、コーヒーが淹れ終わる前に最初のモデル着用画像が手に入ります。

アカウントを作成してAPIキーを取得 API

13 件のリソースエンドポイント
Bearerキー
600 リクエスト/分

Photta API リソースエンドポイント すべての生成に必要なID群

各リソースエンドポイントと取得用のAPIコール

マネキン

ジュエリーマネキン

ポーズ

衣服の着丈とフィット感

背景

ブランドラベル

フットウェア

アカウント

使用状況

リソースエンドポイントに関するFAQ

これらのIDの使用先

5分でAPIを試す

Photta API リソースエンドポイントすべての生成に必要なID群