AGTCloud API Docs
ガイドAPIリファレンス連携とリソース更新とヘルプ

クイックスタート

API Keyを取得し、最小構成の例でテキスト、画像、動画モデルを呼び出します。

API Keyを取得し、最小構成の例でテキストチャット、画像生成、動画生成を呼び出します。

ステップ1:アカウントを作成する

アカウントはAGTCloudで登録します。すでにアカウントをお持ちの場合は、そのままログインできます。

ステップ2:API Keyを取得する

  1. API Keysを開きます。
  2. APIキーを作成をクリックします。
  3. API Keyをコピーし、安全に保管します。

API Keyを安全に保管してください

完全なAPI Keyをブラウザのフロントエンド、公開リポジトリ、スクリーンショット、ログに保存しないでください。漏えいが疑われる場合は、直ちに無効化してください。

AGTCloudのAPI Key管理ページ。APIキーのメニュー、作成ボタン、管理操作の位置を示しています

ステップ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:モデルを探す

タスクに適したモデルは、モデルマーケットプレイスで探します。呼び出す前に、モデルが対応するプロトコル、パラメータ、現在のアカウント権限を確認してください。

次のステップ

このページの内容