開発者

アシスタントをあなたのアプリ、MCP クライアント、Web サイトへ。どこでも料金はチャットと同じです。

3 ステップで始める

1
キーを作成
プロフィール → 開発者で API キーを取得します。キーはあなたのアカウントとして動作します。
API キーを管理 →
2
ここで試す
下のプレイグラウンドでエンドポイントを選び、キーを貼り付けてテストを押します。
プレイグラウンド →
3
コードに組み込む
用意された cURL、JavaScript、Python の例をコピー。MCP とウィジェットはタブにあります。
ドキュメント →

プレイグラウンド

エンドポイントを選び、パラメーターを入力してテストを押します。リクエストは本物で、コードはそのまま使えます。

POST/api/v1/conversations

会話を開始: { text, locale?, model?, tools? } — tools で画像、動画、音楽、音声を生成。

ヘッダーAPI キーログインAuthorization: Bearerこのページのメモリにのみ保持され、どこにも保存されません。

ボディtextmodel

tools

空欄ならアシスタントが判断します。動画と音楽はバックグラウンドで生成されるので、会話を読んで結果を確認してください。

回答を待つ

実際のリクエストです: メッセージ料金がクレジットから差し引かれます。 (1 クレジット)

コード

curl -X POST "https://yapayzeka.my/api/v1/conversations" \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"text":"…","locale":"ja"}'

レスポンス本文

ここにレスポンスが表示されます。

ドキュメント

認証

プロフィール → 開発者で API キーを作成し、すべてのリクエストでヘッダーとして送ってください。キーはあなたのアカウントとして動作します。共有しないでください。

Authorization: Bearer sk_...

REST API

JSON で送受信します。回答はバックグラウンドで作成されます。メッセージを送り、`pending` が false になるまで会話を読み取ってください。

POST/api/v1/conversations会話を開始: { text, locale?, model?, tools? } — tools で画像、動画、音楽、音声を生成。
POST/api/v1/conversations/{id}メッセージを追加: { text, locale?, model?, tools? }
GET/api/v1/conversations/{id}最新メッセージと `pending` 状態
GET/api/v1/conversations最近の会話
GET/api/v1/credits残りのクレジット
GET/api/v1/tools利用できるツールと料金

curl -X POST https://yapayzeka.my/api/v1/conversations \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Merhaba", "locale": "ja", "thinking": false}'
# → {"id": "…"}  — 数秒後に回答を読み取る
curl https://yapayzeka.my/api/v1/conversations/{id} -H "Authorization: Bearer sk_..."

任意フィールド: thinking(false → 推論オフ、より速く安い回答)、instructions(このターン用のシステム指示、最大 20,000 文字。毎回のリクエストで送信)、private(true → プランが非公開チャットに対応していない場合は 402 needs-private)。取得したメッセージの reasoning フィールドにモデルの推論が入ります。

エラー: 401 無効なキー · 402 クレジット不足または Pro が必要 · 409 前の回答が処理中または同意が必要 · 429 レート制限。