3D・画像生成、そしてその先のすべてを — API ひとつで。
主要なエンジンで生成し、同じアセット上でリメッシュ・リテクスチャ・リグ・エクスポートまで — すべてをひとつの非同期 REST API で。アプリ、アセットパイプライン、AI エージェントのために設計しました。
アーリーアクセス — 開発者を順次オンボーディングし、承認後にキーをお送りします。
# Generate a 3D model from an image
curl -X POST https://api.picoberry.ai/v1/models/from-image \
-H "Authorization: Bearer pb_live_xxx" \
-H "Content-Type: application/json" \
-d '{"imageUrl":"https://…/ref.png","engine":"tripo"}'
# → returns an asset id; poll until it's ready
{ "success": true, "data": {
"id": "019f3a39-0db2-…",
"taskStatus": 0,
"type": "model_3d"
} }単なる3Dモデルのエンドポイント、その先へ。
5つの生成 API を個別に組み込む必要はありません。生成・仕上げ・配信をひとつの統合で — 各エンジンを自分で呼び出す代わりに PicoBerry を通す理由です。
ひとつの統合
Tripo、Meshy、Hunyuan3D、そして画像モデルまで、ひとつのキー・スキーマ・{ success, data } レスポンス形式で扱えます。フィールドひとつでエンジンを切り替えます。
完全なアセットパイプライン
生成後、同じアセットを id でリメッシュ・リテクスチャ・リグ — 再アップロードも、ツールごとのフォーマット調整も不要です。
プロダクション仕様
非同期ジョブ、署名付き Webhook、署名付きダウンロード URL、失効可能なキー、レート制限、クレジット追跡 — 本来なら自分で構築・保守するはずだった基盤を提供します。
API が生み出す結果をご覧ください。
プロンプトをひとつ入れれば、テクスチャ付きメッシュが出力されます — キャラクター、クリーチャー、環境、小物、武器、乗り物まで。すべてのタイルは、たった1回の API 呼び出しで作られた実際のアセットです。
テキスト → 3Drealistic 3d model of gunsmith store wild west
テキスト → 3DYellow Scuba Tank Starfish
テキスト → 3DWolf Monk With Staff (Remeshed)
テキスト → 3DAnime Girl In Sci-Fi Suit
テキスト → 3DBanana Palm Tree
テキスト → 3DCartoon Lion Safari Guide (Animated: Standing Relax)
テキスト → 3DAAA game-ready playable male character for ORITHAL, a 3D isometric Ancient Fanta
テキスト → 3DStylized Green Bushy Tree
テキスト → 3Dvalheim style viking boat
テキスト → 3DBrazilian Soccer Player Bobblehead
テキスト → 3DA massive, game-ready 3D monster model of an armored magma golem, with volcanic
テキスト → 3DGothic Stone Pedestal with Gems
テキスト → 3DStylized Purple Flower
テキスト → 3Dcreate a pirate village building
テキスト → 3DSci-Fi Round Device
テキスト → 3DA charming, whimsical two-story medieval-style house with exaggerated, inviting
テキスト → 3DA tall, slender anime-style palm tree stands gracefully, its trunk a smooth, war
テキスト → 3DAnime Girl With Horns
テキスト → 3DAnime Boy Adventurer Character
テキスト → 3DA low poly automatic gun for the use in my low poly fps game
テキスト → 3Dlow poly semi automatic pistol, hard surface, clean edges, stylized FPS game wea
テキスト → 3DCute Mermaid Hair Styles
テキスト → 3DCartoon Taco Filled With Beans
テキスト → 3DChibi Elf Girl T-Pose
テキスト → 3DChibi Anime Girl Knight (Remeshed)
テキスト → 3DChibi Nun Character
テキスト → 3DChibi Cyberpunk Girl Character
テキスト → 3DUnderwater Mermaid Treasure Hunt
テキスト → 3Dspacecraft air carrier
テキスト → 3DStylized 3D mobile game Frost King character, under 7000 triangles, clean topolo
curl -X POST https://api.picoberry.ai/v1/models/from-text -H "Authorization: Bearer pb_live_…" -d '{"prompt":"armored magma golem, glowing cracks, low-poly","engine":"hunyuan-3.1"}'
4ステップでアセットのダウンロードまで。
キーを取得
アクセスを申請し、ダッシュボードでキーを発行して Authorization: Bearer として送信します。
ジョブを送信
POST /v1/models/from-image — または from-text、images。アセット id を返します。
ポーリングまたは Webhook
GET /v1/assets/{id} を taskStatus: 2 になるまで確認するか、署名付きコールバックを受け取ります。
ダウンロード
署名付きの GLB/FBX URL を取得します — または先にリメッシュ・テクスチャ・リグで仕上げることもできます。
詳しい手順はドキュメントで — 認証、非同期 & ポーリング、Webhook。
アセットパイプラインのすべての工程を、エンドポイントとして。
生成後、同じアセット上でそのまま仕上げます — API を離れずにリメッシュ・リテクスチャ・リグまで。
テキスト → 画像
レファレンス誘導(最大4枚)付きのプロンプト画像生成。結果をそのまま画像 → 3D に渡せます。
テキスト → 3D
アセットをテキストで説明するだけ。エンジンとポリゴン数を選べば、PBR テクスチャがデフォルトで付きます。
画像 → 3D
どんな画像でも — 自分で生成した画像も含めて — テクスチャ付きメッシュに変換します。
リメッシュ
目標のトライアングル数またはクアッド数にリトポロジーします。見た目はそのまま、ポリゴン数だけ削減。
リテクスチャ
プロンプトやレファレンス画像から、PBR マテリアルをその場で塗り直します。
オートリグ & アニメーション
ヒューマノイドを自動でリグし、歩く・走る・待機のクリップをリターゲットします — 手動ウェイト調整は不要です。
エクスポート
GLB、FBX、OBJ で — チャンネル分割マップと .meta を同梱する Unity テクスチャプリセットに対応。
アセット & コレクション
生成したすべてを一覧・取得・整理します。署名付き URL で、すぐにダウンロードできます。
リクエストごとに最適なエンジンを選択。
ジョブごとに engine フィールドをひとつ指定するだけ。エンジンごとに強みが異なります — まずはデフォルトで始め、特定のルックや予算が必要になったら切り替えてください。
| エンジン | 種類 | 適した用途 | 入力 | 出力 | 目安時間 |
|---|---|---|---|---|---|
| Tripo | 3D | 高速で安定したテキスト・画像 → 3D | text · image | GLB · FBX | ~60–90s |
| Meshy | 3D | スタイライズド3Dアセット | text · image | GLB · FBX | ~2 min |
| Hunyuan3D | 3D | 高精細でシャープなジオメトリ | text · image | GLB · FBX | ~2–3 min |
| gpt-image | 画像 | 精密なプロンプト・レファレンス編集 | text · image | PNG | ~20–40s |
| nano-banana | 画像 | 高速な画像生成・編集 | text · image | PNG | ~10–20s |
| grok-imagine | 画像 | xAI Imagine — スタイライズド生成・編集 | text · image | PNG | ~15–30s |
目安時間は標準的なジョブの場合で、複雑なアセットはより長くかかります。正式なカタログとモデル別のクレジット費用は、常に GET /v1/models で確認できます。
プロンプトから、出荷できるアセットまで。
数分でシーンを埋める
プロンプトひとつで小物のバリエーションをまとめて生成し、それぞれを約5kトライアングルにリメッシュして、Unity 対応 GLB として書き出します — ひとつのパイプライン、ひとつのアセット id で。
必要なときにアセットを
AR 試着やワールド構築向けの、軽量でテクスチャ付きのローポリメッシュを生成し、アプリが実行時に取得する署名付き URL で配信します。
商品を3Dに
商品写真1枚を、Web ビューア向けのインタラクティブな3Dプレビューに変換します — 画像 → 3D、Web 予算に合わせたリメッシュ、そして GLB 書き出し。
LLM のための3Dツール
PicoBerry を MCP ツールとして公開すれば、エージェントが自らアセットを生成・仕上げ・ダウンロードできます — テキストや画像を入れれば、GLB が出ます。
連携する前に。
アクセスの取得と認証の方法は?+
Authorization: Bearer pb_live_…(または x-api-key)として送信してください。生成は同期方式ですか?+
taskStatus: 0 のアセット id を返します。GET /v1/assets/{id} を taskStatus が 2(成功)になるまでポーリングするか、Webhook を登録して結果をプッシュで受け取ってください。料金はどのように発生しますか?+
GET /v1/credits で確認できます。レート制限はどうなっていますか?+
error.code: 10003 とともに 429 を返します — 少し待ってから再試行してください。どのフォーマットで書き出せますか?+
GLB(単一ファイル)、またはテクスチャとともに .zip にまとめた FBX / OBJ。Unity プリセットはチャンネルを分割し、.meta を同梱します。Webhook を受け取れますか?+
callbackUrl と webhookSecret を渡せます。完了時に PicoBerry が署名付きの asset.succeeded / asset.failed イベントを POST します。X-PB-Signature の HMAC を検証し、X-PB-Delivery-Id で重複を排除してください。エンジンを自分で選べますか?+
engine フィールドを指定します(3D は tripo、meshy、hunyuan-3.1、画像は nano-banana、gpt-image、grok-imagine)。省略すると、そのジョブ種別のデフォルトを使用します。リアルタイムのカタログとモデル別費用は GET /v1/models にあります。ジョブが失敗するとどうなりますか?+
error.code が含まれます。エラー処理を参照してください。プロダクションで使えますか?+
連携をどうテストすればいいですか?+
GET /v1/credits でいつでも残高を確認できます。SDK や OpenAPI 仕様は提供されますか?+
GET /api-json で提供されます — Postman にインポートしたり、型付きクライアントを生成したりできます。言語別 SDK はまだ公開していませんが、それまでは仕様からほとんどの言語のクライアントを生成できます。アセットの所有権は誰にありますか? 商用利用はできますか?+
アップロードしたファイルは保存されますか? アセットはどれくらい保管されますか?+
API キーを取得しましょう。
PicoBerry ダッシュボードにログインしてキーを発行してください — 表示は一度きりです。