Graydient AIレンダリングAPI
アプリ、社内ツール、レンダーパイプラインを構築するなら、Graydientは専用GPU上のオープン画像、動画、LLMモデルを一つのAPIで、月額定額で提供します。
どのプランに含まれるか
パーソナルAPIはVideo Maxのみ付属します。ImagesとVideo PlusにはAPIアクセスは含まれません。請求ポータルでいつでもアップグレード、ダウングレード、キャンセル可能で、日割り計算されます。ビジネスプランとAPI料金はbusiness.graydient.aiにあります。
パーソナルAPIは一人の人間ユーザー用のキーであり、自動トラフィックはどのパーソナルプランでも許可されていません。つまりボット、スクリプト、スケジューラー、バッチジョブ、スクレイパー、マルチユーザーアプリ、再販アクセスは禁止です。レート制限があり、約10秒に1回の呼び出しに抑えてください。自動または過剰なトラフィックを送るキーは予告なく無効化されます。
マルチユーザーやホワイトラベル製品の構築
仮想ユーザーとホワイトラベルログインは多ユーザー向けのビジネスレベル機能で、パーソナルAPIでも動作します。開発中はVideo Maxでマルチユーザーやホワイトラベルのフローを構築・テスト可能。
マルチユーザー製品の公開、自動トラフィック、再販アクセスにはビジネスプラン：専用GPUサーバーが必要です。business.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アクセス、終日バッチレンダリングを計画している場合は、ビジネスプラン：専用GPUサーバーが必要です。専用マシンで共有キューなし。価格、内容、注文フォームはbusiness.graydient.aiにあります。
専用サーバーのレンダリングごとの価格（ビデオ含む）はbusiness.graydient.aiに記載されています。このレンダリング単価はビジネスプランのみ適用されます。Images、Video Plus、Video Maxは定額制でレンダリング単価はありません。
自動トラフィックはパーソナルプランで許可されていません。Images、Video Plus、Video Maxは一人の人間ユーザー向けの定額プランで、自動トラフィックを送るキーは無効化されます。
始め方
- Video Maxを購読。プランは請求ポータルでいつでも変更・キャンセル可能。
- APIトークンページでトークンを作成。
- APIドキュメントを読み、GitHubでGraydient APIの使用例を確認。
- Webhookエンドポイントを設定し、最初のレンダリングリクエストを送信。
- ドキュメントの推奨通り、結果画像はユーザーに提供する前にミラーリングとサムネイル作成を。
APIサポートはinfo@graydient.aiでメール対応。すべての利用は許容使用ポリシーと利用規約に準拠。