yumoqing/sage
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
sage/wwwroot/public/api/api_jp.md

8.4 KiB
Raw Permalink Blame History

元境プラットフォーム API

元境（Yuanjing）プラットフォームは、下位システム向けに OpenAI インターフェースプロトコルと互換性のある API を提供します。API を有効にするには、以下の手順に従ってください：

  • アカウント登録
  • ログイン
  • APIKEY の申請
  • チャージ（入金）

上記の手順完了後、以下の例に従ってテキスト生成、テキストから動画（T2V）、画像から動画（I2V）、リファレンスから動画（R2V）の推論サービスを実装できます。

サポートされているモデルについては、「モデル広場（Model Square）」をご参照ください。

APIKEY の申請

ユーザーは元境プラットフォーム（https://ai.opencomputing.cn）に携帯電話でログインし、「APIKEYの作成（创建APIKEY）」をクリックする必要があります。

情報を入力して送信すると、APIKEY の作成が完了します。

「apikeyをコピー（复制apikey）」をクリックし、ポップアップウィンドウに表示された APIKEY をコピーしてください。

チャージ

ユーザーは元境プラットフォーム上でチャージを行う必要があります。現在、Alipay（支付宝）に対応しています。

現在の残高確認

  • ユーザーログイン
  • ユーザーメニューを呼び出す
  • 「財務（财务）」をクリック

API ベース URL

https://opencomputing.ai

OpenAI 互換インターフェース

OpenAI と互換性のある一連の API を提供しています。

テキスト生成

  • パス: /llmage/v1/chat/completions
  • メソッド: 'POST'
  • ヘッダー
{
    "Content-Type": "application/json",
    "Authorization": "Bearer <your-apikey>"                # 元境プラットフォームから申請したAPIKEY
}

  • データ { "model": # モデル識別コード（プロバイダーから提供されたモデル名） "prompt": # プロンプト（必須入力） "sys_prompt" # システムプロンプト（任意） "stream" # ストリーミング出力スイッチ "..." # その他のパラメータ }

  • レスポンス OpenAI プロトコルに準拠したストリーミングまたは非ストリーミングの結果を返します。

  • ストリーミング：

./oc.curl 你是谁
data: {"id": "chatcmpl-2665dfd8-e05f-9d7f-adff-3c53c174a454", "object": "chat.completion.chunk", "created": 1775019761, "choices": [{"logprobs": null, "index": 0, "delta": {"content": "", "role": "assistant"}}], "model": "qwen3-max", "reasoning_content": null, "content": "", "finish": "0", "llmusageid": "K9_veNBxeqvrFfbGWXs0R"}
...
data: [DONE]
  • 非ストリーミング
./oc.curl 你是谁
{"id": "chatcmpl-eea7abb9-24d5-9f70-b6f6-d7da4f22a8b8", "object": "chat.completion", "created": 1775011902, "choices": [{"finish_reason": "stop", "index": 0, "message": {"content": "我是通义千问...", "role": "assistant"}}], "model": "qwen3-max", "usage": {"total_tokens": 70}}

テキストから動画 (Text-to-Video)

現在サポートされているモデル：

モデルID プロバイダー モデル名
o5vfXYD5BURJWRTWpopE5 Alibaba Cloud happyhorse-1.0-t2v
YjjGgxO_Xma8PWsMjJvps Doubao doubao-seedance-2-0-260128
TWay-xd0p0pkEX-_Kuhto We Token AI dreamina-seedance-2-0-260128(*), dreamina-seedance-2-0-fast-260128
CrEMkFQfRCmbmopZsCqLj Doubao doubao-seedance-1-5-pro-251215
u9HZyfDoqU6uKI6M1BTks Tongyi Wanxiang wan2.6-t2v
r0ill7L0s6PtBS8mkmg-7 vidu viduq3-pro

happyhorse-1.0-t2v アップロード要件

フィールド名 (Name) タイプ 必須 デフォルト値 説明
llmid モデル番号 はい - -
model モデル名 いいえ happyhorse-1.0-t2v -
prompt string はい - プロンプト。生成したい動画の内容を記述します。
resolution string いいえ 720p 動画サイズ（解像度）。
選択肢:
480p, 720p, 1080p
ratio string いいえ adaptive アスペクト比。選択肢: adaptive, 16:9, 4:3, 1:1, 3:4, 9:16, 21:9
duration integer いいえ 5 動画の長さ（秒）。
選択肢: 整数

seedance 2.0 アップロード要件

フィールド名 (Name) タイプ 必須 デフォルト値 説明
llmid モデル番号 はい - -
model モデル名 いいえ doubao-seedance-2-0-260128 doubao-seedance-2-0-260128 または doubao-seedance-2-0-fast-260128
prompt string はい - プロンプト。生成したい動画の内容を記述します。
resolution string いいえ 720p 動画解像度。
選択肢:
480p, 720p, 1080p
ratio string いいえ adaptive アスペクト比。
duration integer いいえ 5 動画の長さ（秒）。

万象 (Wanxiang) アップロード要件

フィールド名 (Name) タイプ 必須 デフォルト値 説明
llmid モデル番号 はい - -
prompt string はい - プロンプト。生成したい動画の内容を記述します。
negative_prompt string いいえ (空) ネガティブプロンプト。動画に含めたくない内容を記述します。
size string いいえ 1920*1080 動画サイズ。
選択肢:
1280*720, 1920*1080 等
duration integer いいえ 15 動画の長さ（秒）。
選択肢: 5, 10, 15

例 (Example)

seedance を使用した例：

#!/usr/bin/env bash
curl -X POST https://opencomputing.ai/llmage/video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-apikey-from-opencomputing.ai" \
  -d '{
        "llmid": "CrEMkFQfRCmbmopZsCqLj",
        "prompt": "小猫在抓老鼠",
        "duration": 5,
        "ratio": "16:9",
        "resolution": "480p"
    }'

画像から動画 (Image-to-Video)

快乐马 (Happy Horse) アップロード要件

最初のフレームからの動画生成のみサポートしています。

フィールド名 (Name) タイプ 必須 デフォルト値 説明
image1_file 画像ファイル はい - 最初のフレーム画像。
resolution string いいえ 720p 解像度。720P, 1080P

例：

#!/usr/bin/env bash
curl -X POST https://opencomputing.ai/llmage/video \
  -H "Authorization: Bearer <your-apikey>" \
  -F "llmid=o5vfXYD5BURJWRTWpopE5" \
  -F "prompt=一起来调科目三" \
  -F "duration=15" \
  -F "resolution=720P" \
  -F "image1_file=@./02.jpg"

リファレンスから動画 (Reference-to-Video)

seedance 2.0 アップロード要件

フィールド名 タイプ 必須 デフォルト値 説明
image_files 配列 はい [] リファレンス画像配列。
video_files 配列 いいえ [] リファレンス動画配列。

タスク送信

  • パス: /llmage/video
  • メソッド: POST
  • ヘッダー
{
    "Content-Type": "application/json",
    "Authorization": "Bearer <your-apikey>"             # 元境プラットフォームから申請したAPIKEY
}
  • レスポンス
{
    "taskid":                               # タスクID。後の実行結果照会に使用します。
    "status":                               # 状態: SUCCEEDED, FAILED, CREATED, PENDING, RUNNING
}

タスク状態の照会

  • パス: /llmage/tasks
  • メソッド: GET
  • ヘッダー
{
    "Content-Type": "application/json",
    "Authorization": "Bearer <your-apikey>"
}
  • パラメータ
{
    "taskid": "936759404378734592"
}
  • レスポンス
{
    "status":                           # 状態
    "usage":                            # status==SUCCEEDED時に有効。課金情報。
    "image":                            # 動画カバーURL
    "video":                            # 動画URL
}

エラーメッセージ

  • 401: {"error": "Invalid API Key"} (無効なAPIキー)
  • 400: {"error": "Missing required parameter: prompt"} (必須パラメータ不足)
  • 429: {"error": "Insufficient balance"} (残高不足)