Nubint API ドキュメント
Nubint API の認証、エンドポイント、レスポンス形式をまとめています。原稿レビュー、科学図、エビデンス統合を同じキーで呼び出せます。
概要
すべてのリクエストは HTTPS で送る JSON です。原稿チェック、論文検索、データのグラフは、結果がレスポンスにそのまま含まれます。図や文献調査のように数分かかる処理は taskId を返し、結果はタスクの照会で読み取ります。
https://api.nubint.ai/api/v1レスポンスのフィールド名は camelCase です。例外として、書誌(csl)は CSL-JSON 標準のキー(container-title、DOI など)を、指摘の params は snake_case のキーをそのまま使います。
認証
毎回のリクエストで X-API-Key ヘッダーに API キーを入れます。Authorization ヘッダーではありません。
キーは Nubint アプリの 設定 → API/MCP で発行します。nbk_live_ で始まり、発行直後に一度だけ表示されます。サーバーにはハッシュだけを保存するため、紛失した場合は再発行が必要です。
有効なキーはアカウントあたり 10 個までです。漏えいが疑われる場合は同じ画面ですぐに無効化してください。無効化したキーは即座に拒否されます。
すべてのパスに Starter・Pro・Max プランが必要で、無料プランのアカウントのキーで呼び出すと 403 が返ります。キーはそのまま残り、購読すると同じキーで使えます。クレジットのかからないツール(論文検索、ライブラリ、原稿の保存、文書の読み取りと修正の提案、タスクの確認)と参考文献の実在確認では、クレジットは差し引かれません。
Nubint
参考文献の実在確認
参考文献リストの各項目が実在する文献を指しているか、学術インデックスと照合します。言語モデルを呼び出さないため、同じ入力には同じ結果が返ります。 参考文献が `.bib` ファイルにある場合は、その中身を `referencesBibtex` に入れても構いません(サーバーが 1 行ずつに変換して追加します)。
リクエスト
参考文献文字列の配列。本文ではなく References セクションの項目を 1 つずつ入れます。最大 100 件。DOI があれば一緒に含めてください。照合が正確になります。
レスポンス
判定。下の「判定値」を参照してください。
判定の根拠 — identifier(DOI などの識別子が一致)、title_exact、title_strong、title_partial、parsed(インデックス外、書誌のみ解析)、none。
インデックスで見つかった論文の書誌と識別子。verified と uncertain のときだけ入ります。
インデックス外の文献を原文から解析した書誌(CSL-JSON)。off_index のときだけ入ります。
採用されたインデックス候補のタイトル。uncertain のとき、利用者が自分の参考文献と照らし合わせるために使います。
タイトルの重なりが足りず不採用になった候補のタイトル(off_index のときのみ)。原稿側の表記が間違っている場合の手がかりです。採用された一致ではないため、引用として使ってはいけません。
集計。needsReview は verified 以外のすべて、つまり利用者が確認すべき件数です。
Nubint
AI 作成検出
テキストが AI で書かれたように読めるかを、独立した検出モデルで判定します。段落単位で判定し、該当段落では判定の決め手になった文を順位付きで示します。
リクエスト
チェックするテキスト。段落は空行で区切ります。最大 200,000 文字。
レスポンス
文書全体の判定 — safe・caution・risk・inconclusive。
判定した段落数。
段階が付いた段落数。
このリクエストで請求されたクレジット。inconclusive は 0。
該当した文のリスト。code は段階(likely・possibly)、anchor は原文の文、params.rank はその段落内での順位です。
検出サービスが応答しない場合、このエンドポイントは 502 を返します。結果なしに safe を返すことはありません。
Nubint
原稿全体チェック
本文と参考文献を一度に送ると、参考文献の実在確認、AI 作成検出、出典品質の 3 セクションを返します。参考文献の照合は 1 回だけ行うため、2 つのセクションが同じ論文を見ます。 参考文献が `.bib` ファイルにある場合は、その中身を `referencesBibtex` に入れても構いません(サーバーが 1 行ずつに変換して追加します)。
リクエスト
原稿の本文。空の場合、AI 作成検出と出典品質は skipped になります。最大 200,000 文字。
参考文献文字列の配列。空の場合、参考文献の確認と出典品質は skipped になります。最大 100 件。
レスポンス
AI 作成検出が失敗した例です。ほかのセクションはそのまま結果を返します(一部フィールド省略)。
セクションごとにあります — ok(チェック済み)、failed(当社側の障害で実行できず、再試行で解決)、skipped(入力がなくスキップ)。failed と skipped には reason が付きます。
確認済みの参考文献だけをチェックします — 撤回(retracted_source)、懸念表明(expression_of_concern)、プレプリント(preprint_source・preprint_has_published_version)、被引用の少ない出典(low_citation_source)など。
このリクエストで請求されたクレジット。成功したセクションのみ課金し、failed・skipped と AI 検出の inconclusive は 0。
Nubint
判定値
参考文献の判定 (status)
インデックスで確認済み。DOI などの識別子またはタイトルが一致します。
候補は見つかったものの、タイトルが部分的にしか一致しません。matchedTitle と照らし合わせてください。
このインデックスでは確認できませんでした。単行本・法令・非公開の学術誌など、もともとインデックスにない文献の可能性があります。存在しないという意味ではありません。
書誌項目として読み取れない行です(タイトル・年・著者が見つからない)。
AI 作成検出の判定 (verdict)
このチェックでは AI 作成の特徴が見つかりませんでした。人が書いた保証ではありません。
一部の段落に AI 作成の特徴があります。該当する文を確認してください。
複数の段落に明確な AI 作成の特徴があります。
判定できる文章が足りません(短すぎる、または表・リストが中心)。AI ではないという意味ではありません。
Nubint
指摘オブジェクト
AI 作成検出と出典品質の指摘は同じ形式です。
安定した識別子。画面の文言はこの値で選んでください。
問題となった原文の文。著者-年方式(APA など)の原稿では、出典品質の指摘の anchor が空になることがあります。その場合は reference で論文を特定します。
リクエストで送った text の中で anchor が始まる位置。同じ文が 2 回出てくると文字列検索は最初の方を拾います — 文書にコメントやハイライトを付けるときはこの値を使ってください。位置が分からない場合は null です。単位は Unicode コードポイントで、JavaScript の文字列インデックス(UTF-16)とは絵文字などでずれます。
anchor が終わる位置(anchorStart + アンカーの長さ)。
指摘対象の論文の識別子(canonicalId)。
文言の組み立てに使う値(参考文献番号、被引用数、順位など)。
利用者の言語による指摘文。チェックが文言を生成した場合のみ入ります。
Nubint Figure
図の生成・修正
説明から図を描くか、すでに描いた図を変更します。タスクを開始してすぐに taskId を返し、結果はタスクの照会で読み取ります。図はプロジェクトのキャンバスにも置かれます(レスポンスの url)。
リクエスト
描く内容、配置、ラベル。ラベルは図に入れたい言語で書きます。generate と edit で必要です。
実行する処理 — generate(デフォルト)・edit・recolor・remove_background・white_background・change_ratio・upscale・to_svg・to_pptx。generate 以外は既存の図が対象です。
新しく描く図の種類 — illustration(デフォルト。イラスト・模式図)または flowchart(ボックス・矢印・文字でできたフローチャート・構成図)。
結果を置くプロジェクト。空にすると新しいプロジェクトが作られ、同じ値を渡すと 1 つのキャンバスにまとまります。
変更する図の imageUrl。空にすると、projectId で最後に生成された図が対象になります。
スタイル — flat・2.5d・3d・sketch・line-art・hand-drawn。
配色。action が recolor のときは必須です。
比率 — 16:9・1:1・4:3 など。action が change_ratio のときは必須です。
action が upscale のときの目標サイズ — 2k・4k・8k。
図の内容になるファイルの fileUrl の配列。先に /developer/figure/file でアップロードします。
見た目の手本にする画像の fileUrl の配列。内容は引き継ぎません。
レスポンス
タスクの照会に渡す値。24 時間有効です。
この図のプロジェクト。次のリクエストに渡すと、続きから作業できます。
Nubint Figure でキャンバスを開く URL。文字の修正、領域の描き直し、書き出しはここで行います。
タスクの照会の結果。図なら imageUrl、SVG・PPTX なら fileUrl が返り、creditsCharged にこのタスクで使ったクレジットが入ります。
Nubint Figure
データのグラフ
実データからグラフを描きます。画像モデルではなくコードが描くため値は表のとおりで、結果は同じレスポンスに含まれます。
リクエスト
CSV のテキスト。1 行目が列名です。値は丸めたり補ったりせず、そのまま送ります。
csv の代わりに使います — /developer/figure/file に purpose を data としてアップロードした表(CSV・TSV・XLSX)の fileUrl。Excel は最初のシートを読みます。
ジャーナルスタイル — general(デフォルト)・nature・science・cell・plos-one・acs。そのジャーナルの図でよく使われる幅と文字サイズで描きます。ジャーナルの投稿規定への適合を保証するものではありません。
グラフの種類 — bar・line・scatter・box・violin・heatmap・histogram。
x 軸と y 軸に使う列名。histogram では、区間に分ける数値列を x に指定します。
系列を分ける列。
bar・line で x が同じ行をまとめる方法 — mean(デフォルト)・median・sum・count・none。
エラーバー — none・sd・sem。
配色と比率。
true にすると、編集できる SVG ファイル(svgUrl)も一緒に返ります。SVG 書き出しの料金が加算されます。
グラフを置くプロジェクト。
レスポンス
グラフの PNG(300 dpi)。
実際に描いた値 — 読み込んだ行、描いた行、除いた行の数と、系列ごとの n・平均・標準偏差。数値に触れるときはこの値を引用してください。
このリクエストで請求されたクレジット。描けない表(列がない、数値がない)はクレジットを差し引かず、400 を返します。
Nubint Evidence
論文検索
研究課題やキーワードで学術インデックス(OpenAlex・KCI)を検索します。クレジットはかからず、結果はすぐに返ります。
リクエスト
研究課題またはキーワード。言語は問いません。
返す論文の件数。デフォルト 10、最大 30。
出版年の範囲。片方だけでも指定できます。
最小被引用数、オープンアクセスのみ、撤回された論文の除外。指定した条件だけが適用されます。
並び順 — relevance(デフォルト)・cited・recent・oldest。
レスポンス
論文の識別子。ライブラリに保存するときに、そのまま使います。
原文がインデックスされている場合、クエリに合う段落が一緒に返ります。
結果がないときに付く案内。クエリに検索できるテーマがない場合も、結果は空になります。
Nubint Evidence
文献調査
研究課題から文献調査を書きます。インデックスを検索して主要な論文を選び、引用番号が参考文献と対応するレビューを Markdown で返します。タスクとして実行され、数分かかります。
リクエスト
研究課題またはテーマ。
深さ — fast(デフォルト)・balanced・comprehensive。深いほど、引用する論文数、時間、クレジットが増えます。
結果を書く言語 — ko・en・ja・zh-CN(簡体字)・zh-TW(繁体字)。空にすると英語になります。
レスポンス
この文献調査を指すハンドル。タスクの照会に taskId の代わりに渡すと、24 時間を過ぎても結果を読み直せます。
Nubint で結果を開く URL。
タスクの照会の結果 — レビュー本文と references(本文の [n] と同じ順序)。
Nubint Evidence
システマティックレビュー・データ抽出
システマティックレビュー(プロトコルの提案、スクリーニング、統合レポート)とデータ抽出は近日公開予定です。現時点では API でも MCP でも利用できず、該当するパスを呼び出すと 403 が返ります。
現在利用できるのは、論文検索と文献調査です。公開され次第、リクエストとレスポンスの形式をこのドキュメントに掲載します。
共通
タスクの照会
タスクを開始するパスは、すぐに taskId を返します。結果は、このパスに taskId を送って読み取ります。15 秒から 30 秒の間隔で確認し、遅いからといって同じタスクを開始し直さないでください — 開始するたびに新たに課金されます。
リクエスト
開始時のレスポンスの taskId。24 時間有効です。
taskId の代わりに渡すと、過去の作業の最新の結果をいつでも読み直せます。
レスポンス
running・completed・failed・cancelled。
completed のときの結果。形はタスクごとに異なります(上の各セクションを参照)。
failed のときの理由。
Nubint で結果を開く URL。
料金
AI 作成検出は 1 万トークンあたり 88 クレジット、出典品質は 1 万トークンあたり 66 クレジットです。本文の分量は英文 A4 5 ページ単位で切り上げ、その 1 単位が最低料金です。エディターの AI レビューと同じ単価です。
参考文献の確認にクレジットはかかりません。当社側の障害で失敗したセクション(failed)、入力がなくスキップしたセクション(skipped)、判定できる文章が足りない AI 検出(inconclusive)は差し引きません。
実行前に予想コストを確認し、残高が足りなければ実行せずに 402 を返します。
エラー
エラーレスポンスの本文は detail フィールドを 1 つ持つ JSON です。
上限超過 — 参考文献 100 件または本文 200,000 文字を超えました。切り詰めて処理することはありません。
X-API-Key ヘッダーがない、キーが誤っている、または無効化されたキーです。
クレジットが不足しています — 残高が 0 か、このリクエストの予想コストを賄えません。チェックは実行されていません。
Starter・Pro・Max プランが必要です(無料プランのアカウントのキーでは、すべてのパスがこの応答を返します)。
リクエスト本文の形式が合っていません(フィールド名・型)。
リクエスト上限を超えました。1 分後に再試行してください。
AI 作成検出サービスが応答しませんでした(/developer/review/ai-detection)。しばらくしてから再試行してください。
認証の確認が一時的にできません。キーの問題ではないので、無効化せずに再試行してください。
上限と応答時間
参考文献はリクエストあたり 100 件、本文は 200,000 文字(英文 A4 で約 80 ページ)までです。
レスポンスは同期式のため、参考文献が多いと数十秒かかることがあります。クライアントのタイムアウトは 120 秒以上に設定してください。
リクエスト上限はアカウントあたり、参考文献の確認が毎分 30 回、AI 作成検出と原稿全体チェックが毎分 10 回です。超えると 429 が返ります。
全エンドポイント
MCP ツールはすべて REST でも呼び出せます。パスは /developer/ の後にグループ名と機能名が続き(例: /developer/evidence/literature-review)、MCP ツールと同じ引数を JSON で POST すると同じ結果が返ります。プラン、リクエスト上限、クレジットも同じです。
「タスク」と表示されたパスは数分かかる処理を開始し、すぐに taskId を返します。結果は /developer/tasks/get に taskId を送って読み取ります。15 秒から 30 秒の間隔で確認してください。
search_papers
search_library
save_to_library
run_manuscript_check
run_manuscript_check
run_manuscript_check
save_manuscript
list_documents
read_document
edit_document
start_review
start_literature_review
start_systematic_review
list_screened_papers
update_screening
start_systematic_review_report
start_extract_data
export_evidence
open_figure_project
upload_figure_file
start_figure
create_figure_plot
get_task
list_tasks
get_credits
MCP
MCP サーバーは、原稿チェック(run_manuscript_check — 参考文献の実在確認と AI 作成検出は checks で個別に実行できます)に加えて、論文検索、7 つの原稿レビュー、Nubint 文書の一覧・読み取りと修正の提案(edit_document — 提案は Nubint のエディターに表示され、ユーザーが承認または却下します)、文献調査、図のツールを提供します。すべてのツールは Starter プランから利用できます。システマティックレビューとデータ抽出は近日公開予定です。ChatGPT・Claude はログイン(OAuth)で接続し、API キーは不要です — MCP の接続案内をご覧ください。
MCP の接続方法ツール一覧
サーバーが現在提供しているツールです。start_ で始まるツールは数分かかるタスクを開始してすぐに戻り、結果は get_task で読み取ります。
AI論文検索
AI論文検索
AI論文検索
AI論文レビュー
AI論文レビュー
AI論文レビュー
AI論文レビュー
AI論文レビュー
AI論文レビュー
Nubint Evidence
Nubint Figure
Nubint Figure
Nubint Figure
Nubint Figure
共通
共通
共通
開発ツールから API キーで接続
ヘッダーを設定できる開発ツールは X-API-Key で接続できます。サーバー URL は同じです。
ターミナルで 1 行で追加します。追加後、/mcp で接続状態を確認できます。