Tool Integrations2026年7月17日Flatkey Team

テキストから動画を作る製品チーム向けの Seedance API

Flatkey の認証、ベース URL、使用ログを 1 回のクイックスタートリクエストで確認し、その後、承認済みの Seedance ルートに切り替えて非同期のテキストから動画の評価を行います。

製品チームが Seedance API へのアクセスをできるだけ安全かつ迅速に評価したいなら、最初の一歩は初日から動画ワークフロー全体を構築することではありません。最小限の統合面で、次の3つの基本を証明することです。

Flatkey のキーで正しく認証できる
アプリが https://router.flatkey.ai/v1 を呼び出せる
非同期動画ジョブをつなぐ前に、Usage Logs でリクエストを確認できる

このページでは、その低摩擦なクイックスタートを扱います。

2026年7月17日金曜日時点で、Flatkey の公開クイックスタートでは、開発者に対して引き続き Bearer 認証、OpenAI 互換のベース URL https://router.flatkey.ai/v1、そして最初のスモークテスト用に POST /v1/chat/completions を使うよう案内しています。Flatkey のライブなモデルカタログには、テキストから動画および画像から動画向けの seedance-2.5 と、画像から動画向けの seedance-2.0-i2v も公開されています。Seedance 自身の公開 API ページでは、動画ワークフローを引き続き 非同期タスク作成、ステータスポーリング、Webhook、利用量ベースのクレジット と説明しています。

この組み合わせはオンボーディングで重要です。router へのアクセスパターンはシンプルですが、実際の動画生成ワークフローは同期的なチャット呼び出しではありません。製品チームは、まず最小限のリクエストで router を検証し、その後、Seedance の評価に必要なモデルとジョブフローだけを切り替えるべきです。

Quick answer

確認可能な Seedance の導入パスを、できるだけ少ない構成要素で進めたいときは、次の順序を使ってください。

Step	What to use	What it proves
1. Create a key	Flatkey API key starting with `sk-fk-`	Your team has a valid credential
2. Set one base URL	`https://router.flatkey.ai/v1`	Your app points to the shared router, not a provider-specific endpoint
3. Run the smallest smoke test	`POST /v1/chat/completions` with a simple text model	Auth, headers, routing, and Usage Logs work
4. Swap to the Seedance route	Replace the placeholder model with the approved Seedance model ID	The same access layer can now support your video evaluation workflow
5. Add async handling	Polling or webhook logic for video jobs	Your product is ready for real text-to-video execution

一つだけ覚えるなら、これを覚えてください。最初の cURL リクエストは router の接続確認であり、最終的なテキストから動画のペイロードではありません。

Before you start

必要なのは次の4つです。

Flatkey アカウント
Flatkey API キー
リクエスト用の前払いクレジット
どの Seedance ルートを実際に評価したいかという製品上の判断

多くのテキストから動画チームにとっては、公開モデルカタログを見ると、現在の選択肢を十分に把握でき、会話を始めやすくなります。

Current public model signal on Flatkey	Best use
`seedance-2.5`	Text-to-video evaluation, plus image-to-video if needed
`seedance-2.0-i2v`	Image-to-video only

古いスクリーンショットや社内メモにあるモデル名をハードコードしないでください。動画ルートの利用可否は静的なセットアップガイドよりも早く変わることがあるため、公開日に現在のモデルディレクトリまたはライブカタログを確認してください。

Step 1: create and store the Flatkey API key

Flatkey Console で API キーを作成し、環境変数として保存します。

export FLATKEY_API_KEY="sk-fk-..."

ここは、チームが避けられる摩擦を生みやすい最初の箇所です。キーはブラウザコードや共有のローカルメモではなく、サーバー側に保持してください。評価対象が1人のエンジニアではなく製品チームである場合は、最初からチーム所有のシークレットを使ってください。

Step 2: run the smallest possible router smoke test

Flatkey の現在のクイックスタートでは、最初のリクエストに POST /v1/chat/completions を使用します。最終的な目的が Seedance の動画生成であっても、まずこれを行うのが正しい手順です。なぜなら、非同期ワークフローの複雑さを追加する前に、共通のアクセス層が機能していることを確認できるからです。

curl https://router.flatkey.ai/v1/chat/completions   -H "Authorization: Bearer $FLATKEY_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "Reply with the word connected."}
    ]
  }'

成功レスポンスが返れば、次の5つの有用な点がすぐに分かります。

API キーが有効である
Authorization: Bearer ... ヘッダーが正しい
ベース URL が正しい
クライアントが JSON を正常に POST できる
リクエストがトークン数とコスト付きで Flatkey Usage Logs に表示されるはずである

これは、アクセス層が機能していることを示す、最小でレビュー可能な証明です。

Step 3: understand what the smoke test request is actually checking

chat-completions のスモークテストは、意図的にシンプルです。必要な構造は次のとおりです。

Request field	Why it matters
`Authorization` header	Bearer トークン形式を確認する
`Content-Type: application/json`	リクエスト本文が正しくパースされることを確認する
`model`	ルートがモデル ID を解決できることを確認する
`messages`	本文が OpenAI 互換スキーマに一致していることを確認する

Flatkey の現在の chat-completions ドキュメントでは、製品チームが最初に確認することの多い3つのレスポンスフィールドも案内されています。

choices[0].message.content
model
usage

この最後のフィールドは、リクエストが本当にルーターを通過したことを製品チームと運用チームが確認できる共通の場所を提供するため、オンボーディングに特に役立ちます。

Step 4: swap the placeholder model for Seedance evaluation

スモークテストが通ったら、同じ認証情報と同じルータのベース URL を使い続け、動画ワークフローに固有の部分だけを変更します。

変更しないもの:

Authorization: Bearer $FLATKEY_API_KEY
https://router.flatkey.ai/v1
サーバー側のシークレット管理
ログと請求の確認フロー

次に変更するもの:

スモークテスト後に何が変わるか	なぜ変わるのか
`model`	プレースホルダーのテキストモデルを、承認済みの Seedance モデル ID に置き換えます
リクエストボディの形	動画生成には、チャットの `messages` 配列だけではなく、独自のペイロード項目が必要です
レスポンスの扱い	動画ワークフローでは、即時のテキストだけでなく、ジョブ状態、アセット、または非同期ステータスが返ります
製品ロジック	呼び出しを同期チャットとして扱うのではなく、ポーリングか webhook が必要です

テキストから動画の製品評価では、公開日に安全に使えるプレースホルダーは次のとおりです:

seedance-2.5

画像から動画の評価では、現在の公開ルートは次のとおりです:

seedance-2.0-i2v

これらの名前は、調査を始めるための出発点として使ってください。すべての下流ワークフローが同一のペイロード形状を共有するという約束ではありません。

ステップ 5: Seedance の非同期動画ワークフローに合わせて設計する

これは、多くのクイックスタートが省略するステップです。

Seedance の公開 API ページでは、いまもワークフローを次のように説明しています:

非同期タスク作成
ステータスポーリング
webhook
使用量ベースのクレジット

つまり、本番チームは実際の動画パスに少なくとも次の 4 つの状態が必要だと想定すべきです:

ジョブ状態	アプリが行うべきこと
`queued`	ジョブを記録し、リクエストが受け付けられたことを表示する
`running`	ステータスをポーリングするか、webhook を待つ
`succeeded`	出力アセットを取得し、メタデータを付与する
`failed`	エラーを保存し、再試行するかどうかを判断する

チームが Seedance を同期的なチャット応答のように扱おうとすると、API が正常に動作していても、統合は不安定に感じられます。

製品チーム向けの実践的なオンボーディング手順

最小限の評価ループにしたいなら、次の順序で進めてください:

Flatkey のキーを作成する。
chat/completions のスモークテストを実行する。
リクエストが Usage Logs に表示されることを確認する。
実際にテストしたい現在の Seedance モデル ID を選ぶ。
Seedance 固有の非同期リクエストフローを実装する。
展開を広げる前に、1 つのポーリング経路または 1 つの webhook 経路を追加する。

これにより、ルーター検証と動画ワークフローの実装を分けられるため、オンボーディングのリスクを下げられます。

トラブルシューティング

最初の cURL リクエストで 401 または 403 が返る

通常は、キーが無効、期限切れ、または Bearer トークンとして渡されていないことを意味します。

確認すること:

キーが sk-fk- で始まっている
シェル変数が実際に設定されている
ヘッダーが Authorization: Bearer ... になっている

404 またはルートの不一致

通常は、アプリが誤った URL を参照していることを意味します。

次を使ってください:

https://router.flatkey.ai/v1

リクエストをマーケティングサイトに向けたり、/v1 のサフィックスを外したりしないでください。

リクエストは成功するのに Usage Logs が空のまま

Flatkey のクイックスタートには、数秒待ってから再検索するよう明記されています。それでもログが表示されない場合は、実際に送信したモデル名、APIキー、ベースURLを再確認してください。

スモークテストは成功するが、Seedance のワークフローは動かない

通常、それはアクセス層は問題なく、問題が次のいずれかにあることを意味します。

Seedance のモデルIDが間違っている
動画ペイロードの形が間違っている
非同期ポーリングロジックが不足している
Webhook の処理がまだ実装されていない
製品コードが同期的なテキスト応答を前提にしている

それは失敗ではなく、前進です。認証やルーティングからはすでに問題を切り分けられています。

このクイックスタートで十分な場合

次の問いにチームが答えられるなら、このクイックスタートで十分です。

Flatkey 経由で認証できるか？
OpenAI 互換のクライアント経路を再利用できるか？
プロダクトと運用がリクエストをログで確認できるか？
別のプロバイダーキーを先に追加せずに、テキストのスモークテストから Seedance のルートへ切り替えられるか？

これら4つの質問の答えがすべて yes なら、次の承認ステップは通常、基本的な接続性ではなく、非同期動画ワークフローとコストモデルに関するものです。

展開前に料金面が必要な場合は、チームが本番で使うのと同じ請求面で評価を承認できるよう、次に Flatkey の最新の料金ページを確認してください。

FAQ

Flatkey 経由で Seedance API アクセスを最も速くテストする方法は？

まず Flatkey の現在の POST /v1/chat/completions スモークテストで認証、ベースURL、Usage Logs を確認します。成功したら、プレースホルダのモデルを現在承認されている Seedance のモデルIDに置き換え、非同期の動画ワークフローを構築してください。