インジェストAPI

録音システム・CRM・電話基盤から通話ファイルをプログラムでKoeIQに取り込みます。人手作業なしで自動処理を実現します。

概要

インジェストAPIはX-API-Keyヘッダーで認証するRESTエンドポイントです。JWTトークンは不要で、サーバーサイドの自動連携に最適です。

• エンドポイント: POST /api/ingest/upload
• 認証: X-API-Key: <your_key>
• Content-Type: multipart/form-data
• 対応フォーマット: WAV, MP3, M4A, OGG（最大500MB）

APIキーの取得

1. KoeIQにログインし、設定 → APIキー に移動します。
2. キーを生成 をクリックします。
3. 表示されたキーをコピーして安全な場所に保管します（再表示はできません）。

リクエストパラメータ

コードサンプル — cURL

curl -X POST https://app.koeiq.com/api/ingest/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/call.wav" \
  -F "call_id=CRM-20260316-001" \
  -F "language=ja-JP" \
  -F "operator_id=agent-42"

コードサンプル — Python

import requests

with open("call.wav", "rb") as f:
    resp = requests.post(
        "https://app.koeiq.com/api/ingest/upload",
        headers={"X-API-Key": "YOUR_API_KEY"},
        files={"file": ("call.wav", f, "audio/wav")},
        data={
            "call_id": "CRM-20260316-001",
            "language": "ja-JP",
            "operator_id": "agent-42",
        },
    )
print(resp.json())  # {"voicelog_id": "...", "status": "queued"}

コードサンプル — Node.js

const form = new FormData();
form.append("file", fs.createReadStream("call.wav"), "call.wav");
form.append("call_id", "CRM-20260316-001");
form.append("language", "ja-JP");
form.append("operator_id", "agent-42");

const res = await fetch("https://app.koeiq.com/api/ingest/upload", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", ...form.getHeaders() },
  body: form,
});
console.log(await res.json());

レスポンス

Pre-signed URL（大容量ファイル向け）

500MB近い大容量ファイルや、クライアントから直接S3にアップロードしたい場合は、Pre-signed URLエンドポイントを使用します。

# Step 1: Pre-signed URLを取得
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://app.koeiq.com/api/ingest/presign?call_id=CRM-001&language=ja-JP"

# Step 2: 返却されたURLに直接アップロード
curl -X PUT "<presigned_url>" \
  -H "Content-Type: audio/wav" \
  --data-binary @call.wav

次のステップ