はじめに

PicoBerry APIリファレンス

プログラムによる3D・画像生成のためのリソース指向のREST APIです。テキスト → 画像、テキスト/画像 → 3D はもちろん、生成したあらゆるアセットにリメッシュ・テクスチャ・オートリグを適用できます。

基本URLhttps://api.picoberry.ai
バージョンv1
認証Bearer / x-api-key

このAPIはJSONを受け取り(ファイルアップロードはmultipart/form-data)、JSONを返し、標準のHTTPステータスコードを使用し、すべてのレスポンスを{ success, data }のエンベロープで包みます。生成は非同期です。生成リクエストはアセットのidを返し、完了するとポーリングまたはWebhookで受け取れます。

ここから始めましょう

はじめに
クイックスタート

コピー＆ペーストの4ステップで、APIキーから3Dモデルのダウンロードまで。

はじめに
認証

キーを発行して、最初の認証付きリクエストを送ってみましょう。

はじめに
非同期 & ポーリング

すべてのジョブで生成 → ポーリング → 結果がどのように動作するかを説明します。

生成
テキスト → 3D

アセットを言葉で説明すると、テクスチャ付きのメッシュが得られます。

生成
画像 → 3D

1枚または複数枚(マルチビュー)の画像を、テクスチャ付きの3Dモデルに変換します。

配信
Webhook

ポーリングの代わりに、署名付きコールバックをプッシュで受け取れます。

はじめに
クレジット & 制限

コスト、レート制限、そして失敗時の返金について。

エンドポイント概要

すべてのエンドポイントはhttps://api.picoberry.ai/v1の下にあります。生成は非同期です。生成リクエストはポーリングまたはWebhookで受け取るidを返し、後処理のリクエストはその同じidを使用します。

エンドポイント用途
POST /v1/imagesテキスト → 画像
POST /v1/models/from-textテキスト → 3D
POST /v1/models/from-image画像1枚、または2〜4ビュー → 3D
POST /v1/assets/{id}/remeshモデルのリトポロジー
POST /v1/assets/{id}/textureモデルのリテクスチャ
POST /v1/assets/{id}/animateオートリグ & アニメーション
POST /v1/assets/{id}/downloadGLB / FBX / OBJ をエクスポート （同期）
GET /v1/assets/{id}状態のポーリング & 結果の取得
GET /v1/assetsアセット一覧の取得
GET /v1/modelsエンジンカタログ & モデル別コスト
GET /v1/creditsウォレット残高 & プラン
POST /v1/collectionsアセットをコレクションに整理

ライブラリ

MCP
@picoberry/mcp-server

Claude Code・Cursor・Claude Desktop・Cline からこのAPIをそのまま使用。npx -y @picoberry/mcp-server

ソース
GitHub

MCP サーバーのソース、実例ワークフロー、コピーしてすぐ使えるクライアント設定。

REST
直接呼び出す

SDKは不要です。curl・Python・JavaScript で/v1を呼び出せます。

ひとつのAPIで、すべてのエンジン

リクエストごとに生成エンジンを選べます。3Dはtripo・meshy・hunyuan-3.1・trellis-2、画像はnano-banana・gpt-image。カタログとモデル別の正確なコストはGET /v1/modelsが基準です。