Graydient AIレンダリングAPI
アプリ、社内ツール、レンダーパイプラインを構築するなら、Graydientは専用GPU上のオープン画像、動画、LLMモデルを一つのAPIで、月額定額で提供します。
どのプランに含まれるか
パーソナルAPIはVideo Maxのみ付属：年払いで月額$84（年額$999）、月払いで$99.99。ImagesとVideo PlusにはAPIアクセスは含まれません。請求ポータルでいつでもアップグレード、ダウングレード、キャンセル可能で日割り計算。
パーソナルAPIは1ユーザー用のキーで再販不可。レート制限あり：約10秒に1回の呼び出しを守り、バッチ処理は避けてください。リクエストが多すぎるとキーは自動で失効することがあります。
マルチユーザーやホワイトラベル製品の構築
仮想ユーザーとホワイトラベルログインは多ユーザー向けのビジネスレベル機能で、パーソナルAPIでも動作します。開発中はVideo Maxでマルチユーザーやホワイトラベルのフローを構築・テスト可能。
マルチユーザー製品の本番運用やアクセス再販にはビジネスレベルのオプション（専用GPUサーバーまたはビジネス契約）が必要です。ビジネス展開の相談はinfo@graydient.aiまで。
| パーソナルAPI（Video Max） | ビジネス展開 | |
|---|---|---|
| ユーザー | ユーザー1人（あなた） | あなたの製品のユーザー |
| 再販 | 禁止 | 許可 |
| 仮想ユーザーとホワイトラベルログイン | 構築とテスト | 本番稼働 |
| 入手方法 | Video Maxを購読 | 専用GPUサーバーまたはビジネス契約 |
APIの仕組み
現在のバージョンはV3で、https://cloud.graydient.ai/api/v3/にあります。JSON:API仕様に準拠しており、application/vnd.api+jsonを送受信し、APIトークンページの標準HTTP Bearerトークンで認証し、attributesメンバーを持つdataオブジェクトから結果を読み取ります。
レンダリングは非同期です。プロンプトと必須のcallback_urlを付けてPOST /api/v3/render/にPOSTします。Graydientはすぐにrender_hashと推定待機時間およびレンダリング時間を返します。ジョブが完了すると、結果をあなたのWebhookにPOSTします。オプションのフィールドは以下の通りです。
- error_url：失敗時のWebhook
- init_imageとmask_image：画像から画像への変換やインペインティング用
- placeholders：ControlNetモードやIPアダプター用の名前付き画像URL
- progressive_return：画像ごとに1回のコールバック
- session_id：レンダリングをあなたのユーザーと関連付ける
ワークフローは同じエンドポイントを通じて、プロンプト内のワークフローコマンドで実行されます。
ポーリングなしでのステータス確認：GET GET /api/v3/render/{render_hash}はレンダリングのステータスを返しますが、ドキュメントではポーリングを推奨していません。Webhookを使うか、wss://cloud.graydient.ai/render-events/{render_hash}のWebSocketストリームを利用してください。開始、画像完了、完了、エラーのイベントを送信します。
その他のエンドポイントファミリー
- チャット：ペルソナを持つLLMチャット。返信はコールバックに送るか、sync: trueでインラインで返し、ビジョンモデルはimage_urlを受け入れます。
- コンセプト：利用可能なモデルとLoRAの一覧。
- ワークフロー：ワークフローの一覧とtxt2img、img2img、txt2vid、img2vidなどの対応内容。
- ナレッジベース：ドメイン作成、事実追加、URLクロール、検索やチャット。
- スキル：自然言語のリクエストをワークフローコマンドに変換。
- 仮想ユーザー：エンドユーザーをアカウントのレコードにマッピング。個人APIで構築・テストし、ビジネス展開で本番稼働。
完全なリファレンス：APIドキュメント。ドキュメントはまだ開発中と記載。
典型的な利用例
- 自分のアプリを動かす：Graydientを画像、動画、チャット機能のレンダーバックエンドとして使う。個人APIで開発し、実際のユーザーが増えたらビジネス展開に移行。
- ホストしているモデルを使う：インストール済みのLoRAやチェックポイントでレンダリング。詳細は自分のAIモデルをホストする。
- ComfyAPIスタイルのワークフローをリモートで実行：自分のコードからマッピングされたワークフローを呼び出します。
- 製品やカタログの画像：個人APIのレート制限内で画像のアップスケール、編集、リスタイル。
- バッチレンダリング：持続的な大量バッチには個人APIではなく専用GPUサーバーを使用。
- ナレッジベースチャット：ナレッジベースとチャットエンドポイントでサポートやドキュメントアシスタントを構築。
専用GPUサーバー
マルチユーザー製品の運用、APIアクセスの再販、終日バッチレンダリングを計画している場合、Graydientは月額$499.99の専用Video Max GPUサーバーを提供します。キューなしの専用マシンを持ち、長時間のジョブを実行でき、顧客の操作やキュースロットの時間制限を設定可能。成長に合わせて複数台のサーバーを積み重ねられ、契約は30日通知で長期拘束なし。
専用サーバーのレンダリング料金：専用サーバーのレンダリングは1回$0.02、動画も含む。この1レンダリングあたりの価格は専用サーバーのみ適用。Images、Video Plus、Video Maxプランは定額制でレンダリングごとの課金なし。
レンタル希望はinfo@graydient.aiまでご連絡ください。
始め方
- Video Maxを購読。プランは請求ポータルでいつでも変更・キャンセル可能。
- APIトークンページでトークンを作成。
- APIドキュメントを読み、GitHubでGraydient APIの使用例を確認。
- Webhookエンドポイントを設定し、最初のレンダリングリクエストを送信。
- ドキュメントの推奨通り、結果画像はユーザーに提供する前にミラーリングとサムネイル作成を。
APIサポートはinfo@graydient.aiでメール対応。すべての利用は許容使用ポリシーと利用規約に準拠。