生成

画像 → 3D

POST/v1/models/from-image

あらゆる画像を、自分で生成したものも含めて、テクスチャ付きのメッシュに変換します。

非同期 idを返します。ポーリングまたはWebhook目安約60〜120秒費用 ≈60〜80クレジット

imageUrlを渡すか(JSON)、ファイルをアップロードします(multipart image)。どちらか一方が必須です。より高精度な形状を得るには、同じ被写体の2〜4ビューをimageUrls(または multipart images パート)で送ってください。マルチビューを参照。

パラメーター

パラメーター	説明
imageUrl条件付き string	ソース画像のURL(http/https)。multipart `image` ファイルを送らない限り必須です。PicoBerryが生成した画像の `files.image` URLもここで使えます。
imageUrls条件付き string[]	マルチビュー — 1つの被写体の2〜4ビュー、`[front, left, back, right]` の順。ローカルファイルは multipart `images` パートに入れます。マルチビューは `tripo*`、`meshy6`、`hunyuan-3.x` のみ対応します。下記参照。
engine任意 string	使用する3Dエンジン — 例: `tripo`、`hunyuan-3.1`。省略するとデフォルト。一覧: `GET /v1/models?category=3d`。
polycount任意 integer	目標ポリゴン数、`100`〜`2,000,000`、モデルの範囲に制限されます。
texture任意デフォルト true boolean	PBRテクスチャを生成します。より高速な無テクスチャメッシュには `false` を設定します。

画像ソースは正確に1つ imageUrl、imageUrls、multipart image、multipart images パートのいずれか1つを送ってください。multipart ファイルはURLフィールドより優先されます。

リクエスト

multipart アップロード

curl -X POST https://api.picoberry.ai/v1/models/from-image \
  -H "Authorization: Bearer pb_live_xxx" \
  -F "engine=tripo" -F "image=@./ref.png"

requests.post("https://api.picoberry.ai/v1/models/from-image", headers=headers,
    data={"engine": "tripo"}, files={"image": open("ref.png", "rb")})

const fd = new FormData();
fd.append("engine", "tripo"); fd.append("image", fileBlob, "ref.png");
await fetch(`${BASE}/v1/models/from-image`, { method: "POST", headers, body: fd });

画像入力 単一フレームの png、jpeg、webp、または gif、最大20 MB。URLはサーバー側で取得するため、公開アクセス可能である必要があります。

レスポンス

レスポンス · 200

{ "success": true, "data": { "id": "019…", "taskStatus": 0, "type": "model_3d" } }

呼び出しは即座に返ります。GET /v1/assets/{id} を taskStatus が 2 になるまでポーリングすると、成功時に files.model が署名付きGLBになります。その後、同じ id をリメッシュ、テクスチャ、オートリグで仕上げます。

マルチビュー

同じ被写体の2〜4ビューを送ると、より高精度な1つのメッシュが生成されます。順序は [front, left, back, right](正面が先) — ホスティング済みURLは imageUrls、ローカルファイルは multipart images パートで送ります。クレジットは単一画像の生成と同じです(ビューごとの倍率なし)。

2〜4ビュー

curl -X POST https://api.picoberry.ai/v1/models/from-image \
  -H "Content-Type: application/json" \
  -d '{"engine":"meshy6","imageUrls":["https://…/front.png","https://…/left.png"]}'

requests.post("https://api.picoberry.ai/v1/models/from-image", headers=headers,
    json={"engine": "meshy6", "imageUrls": ["https://…/front.png", "https://…/left.png"]})

await fetch(`${BASE}/v1/models/from-image`, { method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ engine: "meshy6", imageUrls: [front, left] }) });

対応エンジン tripo、tripo-v3.0、tripo-v3.1、tripo-v3.1-ultra、tripo-game-ready、meshy6、hunyuan-3.0、hunyuan-3.1、hunyuan-3.1-lite。その他のエンジンは 400 を返します。