キャラクターとは、同一人物（またはクリーチャー）の5つのビューをまとめたシートです。1枚の写真から作成され、character_idで管理されます。Multi-Ref Videoがクリップ内で人物を認識するために使用するもので、5つのビューがトレーニングなしで人物の外見を保持します。

アプリで作成したキャラクターもすでに利用可能です。ライセンスもリストも同じです（アプリのキャラクターを参照）。

5つのビュー

ロール	ビュー
1	バスト、正面、ニュートラルな表情
2	バスト、斜め（キャラクターが画像の右側を向く）、軽い笑顔
3	バスト、斜め（キャラクターが画像の左側を向く）、ニュートラル
4	全身、正面
5	全身、後ろ姿

各ビューは独立して生成されます。他のビューを左右反転して作成されるものはありません。

キャラクターを作成する

POST /characters（権限: images）。処理は非同期で行われます。

json

{ "name": "Lea", "kind": "woman", "image_b64": "<the photo>", "photo_role": "bust" }

フィールド	型	説明
`name`	文字列、1〜40文字	キャラクターのファーストネーム
`kind`	文字列	`woman`、`man`、または英語で記述したクリーチャー（`baby dragon`）。指示の代名詞を設定します。「they」は使用されません。
`image_b64`	base64	写真: 鮮明で1人のみ、長辺1024px以上、最大12MB、JPEG・PNG・WebP形式
`photo_role`	`bust`（デフォルト）または`full_body`	写真がバストショット（ビュー1になる）か全身ショット（ビュー4になる）かを指定
`outfit`	英語テキスト、任意	最初に着用させる衣装（`a red leather jacket and black jeans`）

レスポンス202は、statusがpendingでcost_estimateを含むキャラクターオブジェクトです。写真は指定したロールのビューになり、サーバーが残り4つを1〜3分で生成します。

価格: 生成されるビュー1つにつき1クレジット、合計4クレジット。outfitを指定した場合はさらに1クレジット（衣装の適用は別ステップとして先に行われます）。失敗したビューは課金されません。POST /characters/quoteで事前に価格を確認できます（outfitは任意）。

状態の確認・チェック・再生成

GET /characters/{id}でキャラクターの状態を取得します。

`status`	意味
`pending`	ビューを生成中
`ready`	5つのビューがすべて揃っている
`partial`	一部のビューが欠けているか失敗している
`failed`、`empty`	使用可能なビューがない

json

{
  "character_id": "chr_8f3a...",
  "name": "Lea",
  "kind": "woman",
  "origin": "api",
  "status": "ready",
  "progress": { "ready": 5, "total": 5 },
  "views": [
    { "role": 1, "name": "bust_front", "status": "ready", "file_url": "https://api.tendre.ai/pro/v1/characters/chr_8f3a.../views/1/file" }
  ],
  "expires_at": "2026-10-19T18:02:11.000Z"
}

最初のレンダリング前にビューを確認してください。 GET /characters/{id}/views/{role}/fileで画像を取得できます。失敗したビューや向きが間違っているビューは、すべての動画で人物の外見に影響します。
ビューの再生成: POST /characters/{id}/views/{role}/redo、1クレジット。元の写真から生成されたビューは再生成できません（vue_photo）。
一覧取得: GET /charactersでキャラクターの一覧を取得します。アプリのキャラクターも含まれ、上限値maxも確認できます。
削除: DELETE /characters/{id}でキャラクターとそのビューを削除します。

アプリのキャラクター

アプリのMy characters画面で作成したキャラクターは、GET /charactersにoriginがappとして表示され、他のキャラクターと同様にMulti-Ref Videoで使用できます。アプリでは、1つのキャラクターに複数のシート（衣装・ムードなど）を持たせることができます。sheet_idで使用するシートを指定し（デフォルトは最新）、sheetsで一覧を確認できます。?sheet=<id>を使うと、ビューの取得・ファイルの取得・再生成時に別のシートを指定できます。Multi-Refクリップでは、characters[].sheet_idでシートを選択します。アプリのキャラクターのビューを再生成する場合は、リクエストボディにkindを指定してください。

ストレージ

ビューは暗号化（ファイルごとに1つのキー）されており、ライセンスに紐付けられています。Proライセンスでは、アプリのキャラクターを含め最大50キャラクターまで保存できます。15日間使用されなかったキャラクターは削除されます（expires_at）。Multi-Refのレンダリングやビューの取得を行うたびに、有効期限が延長されます。送信した写真は、生成されたビューと同様に暗号化され、そのロールのビューとして保持されます。

エージェント経由で使用する（MCP）

MCPサーバーを使えば、「この写真からキャラクターを作って」と伝えるだけです。エージェントがtendre_character_createを使用し（写真はアップロードリンク、ChatGPTに添付したファイル、会話内でレンダリングした画像、または公開URLから取得）、5つのビューを表示し、失敗したビューはtendre_character_redo_viewで再生成します。tendre_character_get、tendre_character_list、tendre_character_deleteでその他の操作をカバーし、tendre_quoteで事前に価格を確認できます。

キャラクターのキャストについては、Multi-Ref Videoを参照してください。

Pro API: Multi-Ref Videoのキャラクターを作成する