クイックスタート
API Keyを取得し、最小構成の例でテキスト、画像、動画モデルを呼び出します。
API Keyを取得し、最小構成の例でテキストチャット、画像生成、動画生成を呼び出します。
ステップ2:API Keyを取得する
- API Keysを開きます。
- APIキーを作成をクリックします。
- API Keyをコピーし、安全に保管します。
API Keyを安全に保管してください
完全なAPI Keyをブラウザのフロントエンド、公開リポジトリ、スクリーンショット、ログに保存しないでください。漏えいが疑われる場合は、直ちに無効化してください。

ステップ3:利用可能な残高を確認する
APIの呼び出しではアカウント残高を消費します。リクエストを送信する前に、残高とチャージページで利用可能な残高を確認してください。チャージ方法と反映結果は、コンソールの表示に従ってください。
ステップ4:最初のAPIリクエストを実行する
以下の例では、現在のサイトのAPIアドレスとサンプルモデルを使用します。実際に呼び出す前に、モデルマーケットプレイスで、現在のAPI Keyが対象モデルを利用できることを確認してください。
LLMとチャットする
Chat Completions互換APIは、OpenAI SDKまたはHTTPリクエストから呼び出せます。
from openai import OpenAI
client = OpenAI(
api_key="your-api-key",
base_url="https://api.agtcloud.cn/v1",
)
response = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[
{"role": "user", "content": "こんにちは。どのようなことができますか?"}
],
)
print(response.choices[0].message.content)レスポンスのテキストはchoices[0].message.contentに格納されます。その他のパラメータについては、Chat Completionsを参照してください。
画像を生成する
curl 'https://api.agtcloud.cn/v1/images/generations' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer your-api-key' \
--data '{
"model": "qwen-image",
"prompt": "雲海の上に浮かぶ未来都市"
}'動画を生成する
curl 'https://api.agtcloud.cn/v1/video/generations' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer your-api-key' \
--data '{
"model": "doubao-seedance-2-5-260628",
"prompt": "青い星雲を通過する宇宙船"
}'作成に成功したら、レスポンスのtask_idを保存し、タスクの状態と結果を確認します。
curl 'https://api.agtcloud.cn/v1/video/generations/your-task-id' \
-H 'Authorization: Bearer your-api-key'すべてのフィールドとタスク状態については、動画を作成と動画を取得を参照してください。
本番環境のAPI Keyを保護してください
your-api-keyは置換位置を示すプレースホルダーです。本番環境では、サーバー側の環境変数またはシークレット管理サービスからAPI Keyを読み取り、実際のキーをコードリポジトリにコミットしたりブラウザのフロントエンドへ送信したりしないでください。
ブラウザでリクエストを確認する場合は、Playgroundを開きます。
ステップ5:モデルを探す
タスクに適したモデルは、モデルマーケットプレイスで探します。呼び出す前に、モデルが対応するプロトコル、パラメータ、現在のアカウント権限を確認してください。
次のステップ
- 画像生成 — 画像の生成と編集について確認します。
- 動画生成 — 動画タスクの作成と取得について確認します。
- 音声処理 — 音声合成、文字起こし、翻訳について確認します。
- サードパーティ連携 — 一般的な開発ツールでAGTCloudを利用します。
- エラーとトラブルシューティング — よくあるリクエストエラーに対処します。