画像と文章から、選択肢ごとの確率を返す判断 API

判断の結果と確率の数値だけを返します。自由記述をパースする必要はなく、 閾値判定や「微妙なケースは有人対応に回す」がそのまま書けます。

Google でログイン API リファレンス 空き枠を確認しています…

会員登録は Google アカウントでのログインのみです。定員制のため、満員のときはログインしたアドレスでウェイトリストに登録されます。

順位付け API のお知らせ

時間のかかる順位付けを受け付け、後から結果を取得できる非同期 API を追加しました。件数や文字数が多い場合は、非同期の順位付けをご利用ください。料金はこれまでと同じで、処理に失敗した場合はクレジットを全額返還します。

非同期処理では入力を国内で一時保管します。保管と削除についてはプライバシーポリシーをご確認ください。

確率で返る

答えは probabilities(選択肢ごとの確率)と confidence つき。しきい値で自動処理と人手確認を分けられます。

画像に対応

1 リクエストに画像 4 枚・質問 10 個まで。画像はリクエスト内で使い回すので、質問を増やしても画像の料金は 1 回分です。

位置バイアスを打ち消す比較

/v1/compare は 2 枚の画像、または 2 つの文章の順番を入れ替えて 2 回聞き、答えが食い違えば undecided を返します。/v1/rank で多数の候補の順位付けもできます。

日本国内で処理

API・推論用の GPU・データベースは、すべて日本国内のサーバーにあります。送った画像や文章は判定のために使い、学習には使いません。非同期の順位付けでは、処理のため国内で一時保管します(プライバシーポリシー)。

リクエストと応答の例

文章(state)・画像(images、data: URL)・選択肢つきの質問(questions)を送ります。

POST https://gyojy.hakadoru.ai/api/v1/judge

{
  "state": "今日は半袖でも心地良い気温でした。",
  "images": ["data:image/jpeg;base64,/9j/4AAQ..."],
  "questions": {
    "temperature": {
      "type": "choice",
      "instructions": "気温として最も適切なのは?",
      "criteria": {"18度": null, "22度": null, "26度": "暑い日"}
    }
  }
}

200 OK

{
  "model": "gyojy-1",
  "served_by": "gyojy",
  "answers": {
    "temperature": {
      "type": "choice",
      "choice": "22度",
      "probabilities": {"18度": 0.0001, "22度": 0.8599, "26度": 0.1401},
      "confidence": 0.7897,
      "coverage": 0.9981
    }
  },
  "usage": {"input_tokens": 117, "output_tokens": 0, "elapsed_ms": 112, "credits": 5}
}

temperature の確率

  • 18度0.01%
  • 22度85.99%
  • 26度14.01%

coverage は選択肢の記号に割り振られた確率の合計です。0.5 を下回るときはモデルが選択肢以外を答えたがっているので、問い方を見直してください。

料金の要点

前払いのクレジット制です。1,100 円(税込)で 100,000 クレジット、11,000 円(税込)で 2,200,000 クレジット。推論・画像・文章の単価を足してリクエストごとに 1 回だけ切り上げるので、送る前に計算できます。

例クレジット
短い文章(100 文字)で質問 1 つ41
画像 1 枚 + 短い文章で質問 1 つ179
compare 1 回(2 回推論 × 画像 2 枚)578
画像 10 枚の順位付け(20 戦)11,035

購入は 1,100 円 / 3,300 円 / 5,500 円 / 11,000 円 / 33,000 円 / 55,000 円(税込)の 6 種類です。表示価格は日本の消費税 10% を含む総額(税込)です。請求先住所が海外の場合は、税抜価格に各国の税が加算されるため、総額が変わります。残高が減ったらメールでお知らせします。料金の詳細

はじめ方

  1. Google でログインし、ダッシュボードでクレジットを購入する
  2. ダッシュボードで API クライアント(client_id / client_secret)を発行する
  3. POST /oauth/token でアクセストークンを受け取り、POST /v1/judge を呼ぶ

API リファレンスとサンプルコード(curl / Python / TypeScript)