Pro API: 自分のサーバーからクラウドレンダリングを操作する

アプリがオンラインで行うすべての処理(画像生成、レタッチ、動画、学習済みキャラクター)は、HTTPでも利用できます。クレジット単価はアプリと同じで、アプリを起動する必要はありません。自分のサーバー、スクリプト、またはエージェントから、ライセンスのクレジットを使って操作できます。

Proライセンスが必要です。 キーはアプリ内の Settings > API から作成できます。

開発者でない方は、コードを一行も書かずにAIエージェントから同じ操作が可能です。詳しくは MCP をご覧ください。

ベースURLhttps://api.tendre.ai/pro/v1
認証ヘッダー Authorization: Bearer tk_pro_...
フォーマット入出力はJSON、画像はPNG、動画はMP4
仕様書openapi.json (OpenAPI 3.0)、クライアント生成に使用
料金一覧GET /pro/v1/pricing

キーを取得する

Proライセンスがある状態でアプリを開き、Settings > API > New key を選択します。名前(例:「production server」)を付け、権限を設定します。必要であれば、1日あたりのクレジット上限と有効期限も設定できます。

キーは一度しか表示されません。 すぐにコピーしてください。紛失したキーは再発行できますが、復元はできません。

  • 1ライセンスにつき同時に使えるキーは最大3つです。 サービスを止めずにローテーションするのに十分な数です。新しいキーを作成して設置してから、古いキーを無効化してください。
  • キーはシートではありません。 PCやスマートフォンは引き続き通常どおり使えます。
  • キーはクレジットと同等の価値があります。 Webページ、配布するアプリ、公開リポジトリには絶対に含めないでください。サーバー上で使用する場合は、必ず1日あたりのクレジット上限を設定してください。

キーで許可される操作

権限許可される内容
Read常に付与されます。レンダーステータス、ファイルのダウンロード、残高、キャラクター一覧
Images画像の送信とキャンセル(生成、レタッチ、バリエーション)、キャラクターの作成
Videos動画の送信とキャンセル。Multi-Ref VideoとFace swapを含む

キーの権限を超えた呼び出しには 403 missing_scope が返され、不足している権限が scope に含まれます。

レンダーのライフサイクル

常に同じ3ステップです。

  1. 送信。 POST /images または POST /videos。即座に jobId とコストが返ってきます。
  2. ポーリング。 GET /images/{jobId} または GET /videos/{jobId} を3秒ごとに呼び出し、status が completed または failed になるまで待ちます。
  3. ダウンロード。 ステータスが completed になったらすぐに GET /images/{jobId}/file または GET /videos/{jobId}/file を呼び出します。ファイルは保持されません。待たずにすぐダウンロードしてください。

おおよその処理時間:画像は10〜40秒、動画は1〜5分、エンジンのコールドスタート時はさらに長くなります。

最初の呼び出し

bash
KEY=tk_pro_...
B=https://api.tendre.ai/pro/v1
curl -s $B/credits -H "Authorization: Bearer $KEY"
json
{ "balance": 1830, "licenseId": "lic_...", "key": "k_1a2b3c4d",
  "limits": { "concurrent": 2, "perMinute": 60, "perDay": 0 }, "running": 0 }

これが正常に返ってくれば、他の操作もすべて動作します。

完全なレンダー、3つの方法

bash

bash
KEY=tk_pro_...
B=https://api.tendre.ai/pro/v1
JOB=$(curl -s $B/images -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"prompt":"a lighthouse at dawn, photorealistic","width":1216,"height":832}' | jq -r .jobId)
until curl -s $B/images/$JOB -H "Authorization: Bearer $KEY" | grep -q '"completed"'; do sleep 3; done
curl -s $B/images/$JOB/file -H "Authorization: Bearer $KEY" -o lighthouse.png

PowerShell

powershell
$H = @{ Authorization = "Bearer tk_pro_..." }
$B = "https://api.tendre.ai/pro/v1"
$job = Invoke-RestMethod -Uri "$B/videos" -Method Post -Headers $H -ContentType "application/json" `
  -Body '{"prompt":"waves on a beach at sunset, gentle wind","width":1080,"height":1920,"audio":true}'
do { Start-Sleep 5; $s = Invoke-RestMethod -Uri "$B/videos/$($job.jobId)" -Headers $H } while ($s.status -eq "pending")
Invoke-WebRequest -Uri "https://api.tendre.ai$($s.file_url)" -Headers $H -OutFile beach.mp4

Python

python
import time, requests
KEY, B = "tk_pro_...", "https://api.tendre.ai/pro/v1"
H = {"Authorization": f"Bearer {KEY}"}
job = requests.post(f"{B}/videos", headers=H, json={"prompt": "waves on a beach at sunset, gentle wind", "audio": True}).json()
while (s := requests.get(f"{B}/videos/{job['jobId']}", headers=H).json())["status"] == "pending":
    time.sleep(3)
if s["status"] == "completed":
    open("beach.mp4", "wb").write(requests.get("https://api.tendre.ai" + s["file_url"], headers=H).content)
else:
    print("failed:", s.get("detail"))

次のステップ

  • Images:生成、3種類のレタッチモード、キャラクター。
  • Videos:フォーマット、料金一覧、開始・終了フレーム、Multi-Ref Video、Face swap。
  • Characters:写真1枚から7つのアングルを生成し、Multi-Ref Videoに使用。
  • Account:残高、上限、学習済みキャラクター、利用履歴。
  • Limits and errors:上限、全エラーコード、推奨プラクティス。
  • MCP (agents):コードなしでClaude、ChatGPT、Cursorをそのまま接続。

まだ対応していない機能

実装予定の順に:自分の写真を使ったキャラクタートレーニング、音声、2Kへのアップスケーリング、レンダーを再現するための固定シード、ポーリング不要にするWebhook。

トレーニングについて補足します。APIを通じてトレーニングを実行することはできませんが、すでに手元にある .safetensors ファイルをアップロードして、すぐにレンダーに使用することは可能です。詳しくは Account, credits and characters をご覧ください。

APIはバージョン管理されています。ここに記載されている内容はすべて /pro/v1 で有効です。追加された機能が既存の動作を壊すことはなく、破壊的な変更は /pro/v2 として提供されます。

Windows・Mac・クラウドまたはローカル

プライベートに生成しましょう。今夜から。

tendre.AIを無料でダウンロードして、自分のGPUでプライベートに無制限生成。

OS Windows 10/11GPU NVIDIA 8GB以上VRAM 12GB推奨ディスク容量 20GB

Mac:Apple silicon(M1以降)、macOS 13以降が必要です。Intel Macには対応していません。

Mac上でのローカル画像生成には、24GBメモリ搭載のM4、または24GB搭載のM2・M3 Pro、Max、Ultraが必要です。それ未満のスペックの場合は、すべてクレジットを使ってオンラインで処理されます。現時点では、レタッチと動画生成はMacでもオンラインで実行されます。

tendre.AI for Macのすべて

NVIDIA GPUをお持ちでない場合は、100%クラウドで始められます。毎日無料で画像5枚と動画1本を利用可能です。NVIDIAカード(8GB以上)があれば、無制限のローカル生成が解放されます。