cURL

curl -X GET https://api.bizmori.com/api/v3/orders/ORDER_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

const orderId = 'ORDER_ID';
const response = await fetch(`https://api.bizmori.com/api/v3/orders/${orderId}`, {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const { data } = await response.json();

import requests

order_id = 'ORDER_ID'
response = requests.get(
    f'https://api.bizmori.com/api/v3/orders/{order_id}',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
data = response.json()['data']

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bizmori.com/api/v3/orders/{orderId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bizmori.com/api/v3/orders/{orderId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bizmori.com/api/v3/orders/{orderId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "type": "antiAi",
    "orderId": "1001",
    "orderName": "cat.png",
    "channel": "api",
    "status": "complete",
    "createdAt": "2026-10-08T01:00:00.000Z",
    "updatedAt": "2026-10-08T01:00:40.000Z",
    "expiresAt": "2026-11-07T01:00:00.000Z",
    "retentionDays": 30,
    "thumbnailImageUrl": "https://cdn.bizmori.com/thumb/ex.webp",
    "processingDelayed": false,
    "errors": null,
    "inputFiles": [
      {
        "fileId": "11",
        "fileName": "cat.png"
      },
      {
        "fileId": "12",
        "fileName": "dog.png"
      }
    ],
    "result": {
      "outputFiles": [
        {
          "fileId": "21",
          "fileName": "cat.png",
          "inputFileId": "11"
        },
        {
          "fileId": "22",
          "fileName": "dog.png",
          "inputFileId": "12"
        }
      ]
    }
  }
}

Orders

注文詳細を取得

所有する注文の詳細を、注文の種類や watermark エンジンに関係なく 1 つの形式で取得します。Anti-AI、AI Detection、watermark 埋め込み・検出の注文を、v2 と v3 のどちらで作成したかに関係なく取得できます。注文のステータスに関係なく、いつでも呼び出せます。

共通のトップレベルフィールド: type、orderId、orderName、channel、status、createdAt、updatedAt、expiresAt、retentionDays、thumbnailImageUrl、processingDelayed、errors、inputFiles、result。すべての注文で同じキーを返し、注文の種類による違いは result の中だけです。

type は antiAi、aiDetection、watermarkEmbed、watermarkExtract のいずれかです。v3 で作成した watermark 注文も、エンジンのバージョン接尾辞なしで同じ値を使います
status は pending、inProgress、complete、failed、expired の 5 つだけです。保存されたステータスが detected / undetected の v2 watermark 検出注文は complete を返し、判定は result.detectionStatus に入ります
processingDelayed は v3 で作成した watermark 注文だけで計算します。それ以外の注文では常に false です
errors は失敗した注文の { errorCode, errorMessage } で、それ以外は null です

inputFiles[]: 入力ファイルごとの { fileId, fileName } をリクエストの順に返します。ファイル数は inputFiles.length で確認してください。

role（original / query）は watermarkExtract の注文にだけ含まれます。v2 注文の watermarked ロールは query として返します
uploadUrl（presigned PUT URL）は、status が pending で、そのファイルがアップロード待ちのときだけ含まれます。それ以外はキー自体がありません（null にはなりません）

result: キーは常にあります。status が complete のときだけオブジェクトで、pending、inProgress、failed、expired では null です。

antiAi: { outputFiles: [{ fileId, fileName, inputFileId }] }
watermarkEmbed: { outputFiles: [{ fileId, fileName, inputFileId, watermarkText }] }。v3 の注文で 1 つの入力ファイルに複数の watermark テキストを埋め込むと、テキストごとに結果ファイルが 1 つずつ作成されます
watermarkExtract: { detectionStatus, watermarkText, reportSupported, reports }。detectionStatus は detected、undetected、inconclusive、unsupported、error のいずれかです。detectionStatus が detected でなければ watermarkText は null です。v2 の注文は reportSupported: false、reports: [] です
aiDetection: { verdict, probability, options, originalImageUrl, heatmapUrl, overlayUrl }。verdict は likely_real、uncertain_real、uncertain_ai、likely_ai のいずれかで、probability が null なら verdict も null です。保存されたオプションがなければ options は null です

fileId: すべての fileId と inputFileId は数字だけの文字列です（- などの区切り文字はありません）。result.outputFiles[].fileId は注文内で一意で、GET /api/v3/orders/{orderId}/download の files[].fileId と値・順序が一致します。

期限切れの注文: expired の注文も取得できますが、result は null で、URL は発行しません。

以前の v3 レスポンスからの変更（破壊的変更、2026-10-08）

v3 で作成した watermark 注文の files[]、outputs[]、トップレベルの reports[] は、inputFiles[]、result.outputFiles[]、result.reports[] に移りました。結果の fileId は {inputFileId}-{n} 形式から数字の文字列に変わりました
detectionStatus の値 not_detected は undetected に変わりました
v2 の詳細と同じ形式だったそれ以外の注文では、トップレベルの fileCount、statusCode、watermarks、watermarkText、probability、options、originalImageUrl、heatmapUrl、overlayUrl が inputFiles と result に移りました。AI Detection の statusCode は result.verdict に変わりました
非推奨（deprecated）の GET /api/v2/orders/{orderId} のレスポンスは変わりません

テストキー（sk_test_）: 同じキーで作成したテスト注文だけを取得します。本番注文と他のアカウントの注文は 404 ORDER_NOT_FOUND を返し、本番キーでテスト注文を取得した場合も同じです。v2・v3 で作成したすべてのテスト注文をこの形式で返します。inProgress のテスト注文は、アップロード完了から 5 秒以上たってから取得すると complete または failed になります。pending のテスト注文の uploadUrl は https://api.bizmori.com/api/v2/test-uploads/{signedToken} です。検出テスト注文の result.reports は常に空の配列で、reportSupported は v3 で作成した検出テスト注文の detectionStatus が detected のときだけ true です。expiresAt は注文作成の 7 日後です。

GET

api

orders

{orderId}

cURL

curl -X GET https://api.bizmori.com/api/v3/orders/ORDER_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

const orderId = 'ORDER_ID';
const response = await fetch(`https://api.bizmori.com/api/v3/orders/${orderId}`, {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const { data } = await response.json();

import requests

order_id = 'ORDER_ID'
response = requests.get(
    f'https://api.bizmori.com/api/v3/orders/{order_id}',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
data = response.json()['data']

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bizmori.com/api/v3/orders/{orderId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bizmori.com/api/v3/orders/{orderId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bizmori.com/api/v3/orders/{orderId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "type": "antiAi",
    "orderId": "1001",
    "orderName": "cat.png",
    "channel": "api",
    "status": "complete",
    "createdAt": "2026-10-08T01:00:00.000Z",
    "updatedAt": "2026-10-08T01:00:40.000Z",
    "expiresAt": "2026-11-07T01:00:00.000Z",
    "retentionDays": 30,
    "thumbnailImageUrl": "https://cdn.bizmori.com/thumb/ex.webp",
    "processingDelayed": false,
    "errors": null,
    "inputFiles": [
      {
        "fileId": "11",
        "fileName": "cat.png"
      },
      {
        "fileId": "12",
        "fileName": "dog.png"
      }
    ],
    "result": {
      "outputFiles": [
        {
          "fileId": "21",
          "fileName": "cat.png",
          "inputFileId": "11"
        },
        {
          "fileId": "22",
          "fileName": "dog.png",
          "inputFileId": "12"
        }
      ]
    }
  }
}

注文のステータスを確認し、結果を読み取るときにこのエンドポイントを使用します。Anti-AI、AI Detection、watermark 埋め込み、watermark 検出のすべての注文を、v2 と v3 のどちらで作成したかに関係なく取得できます。トップレベルのフィールドはすべての注文で同じで、type によって result だけが変わります。

2026 年 10 月 8 日にレスポンスの形式が変わりました。このエンドポイントから files、outputs、トップレベルの reports、fileCount、statusCode を読み取っている場合は、以前のレスポンスからの変更を確認してください。

共通フィールド

フィールド	型	説明
`type`	string	`antiAi`、`aiDetection`、`watermarkEmbed`、`watermarkExtract` のいずれか
`orderId`	string	注文 ID
`orderName`	string \| null	注文名
`channel`	string	`api` または `web`
`status`	string	ステータスの 5 つの値のいずれか
`createdAt`, `updatedAt`	string	ISO 8601 の日時
`expiresAt`	string \| null	注文ファイルが削除される日時
`retentionDays`	integer \| null	ファイルの保管期間（日、7 または 30）
`thumbnailImageUrl`	string \| null	サムネイル画像の URL
`processingDelayed`	boolean	v3 で作成した watermark 注文が手動復旧を待っているときに `true`。それ以外の注文では常に `false`
`errors`	object \| null	失敗した注文の `{ errorCode, errorMessage }`。それ以外は `null`
`inputFiles`	array	入力ファイル。入力ファイルを参照
`result`	object \| null	注文の種類ごとの結果。注文の種類ごとの結果を参照

ステータス

`status`	意味	`result`
`pending`	ファイルのアップロード待ち。`inputFiles[].uploadUrl` があります	`null`
`inProgress`	処理中	`null`
`complete`	完了	オブジェクト
`failed`	処理に失敗。理由は `errors` にあります	`null`
`expired`	保管期限が過ぎ、ファイルは削除済み。URL は発行しません	`null`

v2 で作成した watermark 検出注文のうち、保存されたステータスが detected または undetected の注文は complete を返します。判定は result.detectionStatus から読み取ってください。

入力ファイル

inputFiles[] の各項目には fileId と fileName があり、注文作成リクエストの順に並びます。次の 2 つのキーは該当する場合だけ含まれます。該当しない場合は null ではなく、キー自体がありません。

role は watermarkExtract の注文にだけ含まれます。original は watermark を埋め込んだ元のファイル、query は検査するファイルです。
uploadUrl は status が pending で、そのファイルがまだアップロード待ちのときだけ含まれます。この URL にファイルを PUT してください。アップロード URL の期限が切れた場合は、このエンドポイントを再度呼び出すと新しい URL を取得できます。

このレスポンスとダウンロードのレスポンスのすべての fileId は、"11" のような数字だけの文字列です。- などの区切り文字は含みません。

注文の種類ごとの結果

result は status が complete のときだけオブジェクトです。キーは常にあり、それ以外のステータスでは null です。

Anti-AI
watermark 埋め込み
watermark 検出
AI Detection

result.outputFiles[] には、入力ファイルごとに結果ファイルが 1 つずつあります。

フィールド	型	説明
`fileId`	string	結果ファイル ID。ダウンロードのレスポンスの `files[].fileId` と値・順序が一致
`fileName`	string \| null	結果ファイル名
`inputFileId`	string	元の入力ファイルの `inputFiles[].fileId`

result.outputFiles[] には、埋め込んだ watermark テキストごとに結果ファイルが 1 つずつあります。v3 の注文で 1 つの入力ファイルに複数のテキストを埋め込むと、それらの結果ファイルは同じ inputFileId を持ちます。

フィールド	型	説明
`fileId`	string	結果ファイル ID。ダウンロードのレスポンスの `files[].fileId` と値・順序が一致
`fileName`	string \| null	結果ファイル名
`inputFileId`	string	元の入力ファイルの `inputFiles[].fileId`
`watermarkText`	string	この結果ファイルに埋め込んだテキスト

フィールド	型	説明
`detectionStatus`	string	判定。下の表を参照
`watermarkText`	string \| null	検出された watermark の埋め込みテキスト。`detectionStatus` が `detected` でなければ `null`。v3 の注文では、呼び出し元のアカウントが埋め込み、発行記録がちょうど 1 件のときだけ返します
`reportSupported`	boolean	この結果からレポートを作成できるかどうか。v2 の注文と PDF からキャプチャした画像は `false`
`reports`	array	この注文で依頼したレポートごとの `{ locale, status }`。v2 の注文では常に空の配列

`detectionStatus`	意味
`detected`	watermark が見つかった
`undetected`	最後まで検査したが watermark はなかった
`inconclusive`	候補はあるが、確信度の基準に届かなかった
`unsupported`	処理できない入力。クレジットは返却されます
`error`	検出処理に失敗。watermark なしとは異なります

フィールド	型	説明
`verdict`	string \| null	`probability` に基づく判定。下の表を参照。`probability` が `null` なら `null`
`probability`	number \| null	画像が AI で生成された確率（0〜1）
`options`	object \| null	注文作成時に設定した `generateHeatmap`、`generateOverlay`、`generateThumbnail`
`originalImageUrl`	string \| null	元の画像の URL（1 時間有効）
`heatmapUrl`	string \| null	ヒートマップ画像の URL（1 時間有効）。`generateHeatmap` を使わなかった注文では `null`
`overlayUrl`	string \| null	ヒートマップのオーバーレイ画像の URL（1 時間有効）。`generateOverlay` を使わなかった注文では `null`

`verdict`	確率の範囲	意味
`likely_real`	< 0.25	AI 生成ではない可能性が高い
`uncertain_real`	0.25 – 0.5	AI 生成ではない可能性がある
`uncertain_ai`	0.5 – 0.75	AI 生成の可能性がある
`likely_ai`	≥ 0.75	AI 生成の可能性が高い

例

注文の種類ごとの完了した注文:

{
  "data": {
    "type": "antiAi",
    "orderId": "1001",
    "orderName": "cat.png",
    "channel": "api",
    "status": "complete",
    "createdAt": "2026-10-08T01:00:00.000Z",
    "updatedAt": "2026-10-08T01:00:40.000Z",
    "expiresAt": "2026-11-07T01:00:00.000Z",
    "retentionDays": 30,
    "thumbnailImageUrl": "https://cdn.bizmori.com/thumb/ex.webp",
    "processingDelayed": false,
    "errors": null,
    "inputFiles": [
      { "fileId": "11", "fileName": "cat.png" },
      { "fileId": "12", "fileName": "dog.png" }
    ],
    "result": {
      "outputFiles": [
        { "fileId": "21", "fileName": "cat.png", "inputFileId": "11" },
        { "fileId": "22", "fileName": "dog.png", "inputFileId": "12" }
      ]
    }
  }
}

{
  "data": {
    "type": "aiDetection",
    "orderId": "4001",
    "orderName": "photo.jpg",
    "channel": "api",
    "status": "complete",
    "createdAt": "2026-10-08T01:00:00.000Z",
    "updatedAt": "2026-10-08T01:00:40.000Z",
    "expiresAt": "2026-11-07T01:00:00.000Z",
    "retentionDays": 30,
    "thumbnailImageUrl": "https://cdn.bizmori.com/ai/photo.jpg",
    "processingDelayed": false,
    "errors": null,
    "inputFiles": [
      { "fileId": "71", "fileName": "photo.jpg" }
    ],
    "result": {
      "verdict": "uncertain_real",
      "probability": 0.31,
      "options": {
        "generateHeatmap": true,
        "generateOverlay": true,
        "generateThumbnail": true
      },
      "originalImageUrl": "https://cdn.bizmori.com/ai/photo.jpg",
      "heatmapUrl": "https://cdn.bizmori.com/ai/heatmap.png",
      "overlayUrl": "https://cdn.bizmori.com/ai/overlay.png"
    }
  }
}

{
  "data": {
    "type": "watermarkEmbed",
    "orderId": "2001",
    "orderName": "logo.png",
    "channel": "api",
    "status": "complete",
    "createdAt": "2026-10-08T01:00:00.000Z",
    "updatedAt": "2026-10-08T01:00:40.000Z",
    "expiresAt": "2026-11-07T01:00:00.000Z",
    "retentionDays": 30,
    "thumbnailImageUrl": "https://cdn.bizmori.com/thumb/ex.webp",
    "processingDelayed": false,
    "errors": null,
    "inputFiles": [
      { "fileId": "31", "fileName": "logo.png" }
    ],
    "result": {
      "outputFiles": [
        { "fileId": "201", "fileName": "logo.png", "inputFileId": "31", "watermarkText": "MORI" },
        { "fileId": "202", "fileName": "logo.png", "inputFileId": "31", "watermarkText": "MORI-2" }
      ]
    }
  }
}

{
  "data": {
    "type": "watermarkExtract",
    "orderId": "3001",
    "orderName": "suspect.png",
    "channel": "api",
    "status": "complete",
    "createdAt": "2026-10-08T01:00:00.000Z",
    "updatedAt": "2026-10-08T01:00:40.000Z",
    "expiresAt": "2026-11-07T01:00:00.000Z",
    "retentionDays": 30,
    "thumbnailImageUrl": "https://cdn.bizmori.com/thumb/ex.webp",
    "processingDelayed": false,
    "errors": null,
    "inputFiles": [
      { "fileId": "51", "fileName": "original.png", "role": "original" },
      { "fileId": "52", "fileName": "suspect.png", "role": "query" }
    ],
    "result": {
      "detectionStatus": "detected",
      "watermarkText": "MORI",
      "reportSupported": true,
      "reports": [
        { "locale": "ko-KR", "status": "completed" }
      ]
    }
  }
}

完了していない注文は result: null を返します。

{
  "data": {
    "type": "watermarkExtract",
    "orderId": "3201",
    "orderName": "suspect.png",
    "channel": "api",
    "status": "pending",
    "createdAt": "2026-10-08T01:00:00.000Z",
    "updatedAt": "2026-10-08T01:00:40.000Z",
    "expiresAt": "2026-11-07T01:00:00.000Z",
    "retentionDays": 30,
    "thumbnailImageUrl": null,
    "processingDelayed": false,
    "errors": null,
    "inputFiles": [
      {
        "fileId": "81",
        "fileName": "original.png",
        "role": "original",
        "uploadUrl": "https://bucket.s3.ap-northeast-2.amazonaws.com/inputs/81?X-Amz-..."
      },
      {
        "fileId": "82",
        "fileName": "suspect.png",
        "role": "query",
        "uploadUrl": "https://bucket.s3.ap-northeast-2.amazonaws.com/inputs/82?X-Amz-..."
      }
    ],
    "result": null
  }
}

{
  "data": {
    "type": "watermarkEmbed",
    "orderId": "2002",
    "orderName": "logo.png",
    "channel": "api",
    "status": "failed",
    "createdAt": "2026-10-08T01:00:00.000Z",
    "updatedAt": "2026-10-08T01:00:40.000Z",
    "expiresAt": "2026-11-07T01:00:00.000Z",
    "retentionDays": 30,
    "thumbnailImageUrl": "https://cdn.bizmori.com/thumb/ex.webp",
    "processingDelayed": false,
    "errors": {
      "errorCode": "WATERMARK_FILE_CORRUPTED",
      "errorMessage": "파일이 손상되어 처리할 수 없습니다."
    },
    "inputFiles": [
      { "fileId": "33", "fileName": "logo.png" }
    ],
    "result": null
  }
}

{
  "data": {
    "type": "antiAi",
    "orderId": "1003",
    "orderName": "cat.png",
    "channel": "api",
    "status": "expired",
    "createdAt": "2026-10-08T01:00:00.000Z",
    "updatedAt": "2026-10-08T01:00:40.000Z",
    "expiresAt": "2026-10-01T00:00:00.000Z",
    "retentionDays": 30,
    "thumbnailImageUrl": "https://cdn.bizmori.com/thumb/ex.webp",
    "processingDelayed": false,
    "errors": null,
    "inputFiles": [
      { "fileId": "14", "fileName": "cat.png" }
    ],
    "result": null
  }
}

Pending: まだアップロード待ちのファイルにだけ uploadUrl があります。watermark 埋め込み、Anti-AI、AI Detection の注文には role がありません。
Failed: errors に理由があり、result は null です。errorMessage はエラーコードごとの固定の韓国語の案内文です。
Expired: 保管期限が過ぎた注文も取得できますが、result は null で、URL は発行しません。ダウンロードは 400 ORDER_EXPIRED を返します。

以前のレスポンスからの変更

2026 年 10 月 8 日から、このエンドポイントは上記の形式で応答します。後方互換性のない変更です。

以前のレスポンス	現在
`files[]`（v3 の watermark 注文）	`inputFiles[]`。`uploadUrl` は `pending` の注文にだけあります
`outputs[]`（v3 の watermark 注文）	`result.outputFiles[]`。`outputIndex`、`status`、`mediaKind` は返しません
`"601-1"` 形式の結果 `fileId`	`"201"` のような数字の文字列
トップレベルの `reports[]`	`result.reports[]`
`detectionStatus: "not_detected"`	`"undetected"`
`fileCount`	`inputFiles.length`
`statusCode`（AI Detection）	`result.verdict`
`statusCode` と `status: "detected"` / `"undetected"`（v2 の watermark 検出）	`status: "complete"` と `result.detectionStatus`
`watermarks[]`（v2 の watermark 埋め込み）	`result.outputFiles[].watermarkText`
トップレベルの `watermarkText`、`probability`、`options`、`originalImageUrl`、`heatmapUrl`、`overlayUrl`	`result` の中に移動

非推奨（deprecated）の GET /api/v2/orders/{orderId} は、以前のレスポンスをそのまま返します。

テストキー

sk_test_ キーで呼び出すと、同じキーで作成したテスト注文だけを上記の形式で返します。テスト注文のステータスの変化はテスト API キーを参照してください。

承認

Authorization

string

header

必須

外部クライアントアクセス用のBearer APIキー。本番キーは sk_ プレフィックスを使用し、テストキーは sk_test_ プレフィックスを使用して、処理やクレジット消費なしに注文ライフサイクルを検証します。

パスパラメータ

orderId

string

必須

注文 ID

Pattern: ^[0-9]{1,20}$

レスポンス

注文詳細。トップレベルのフィールドはすべての注文の種類で同じで、type によって result の形式だけが異なります

data

Anti-AI · object

必須

v3 の注文詳細。トップレベルのフィールドはすべての注文の種類で同じ（PublicOrderV3DetailCommon）で、type によって result と検出注文の inputFiles[].role だけが異なります

Anti-AI
watermark 埋め込み
watermark 検出
AI Detection

Hide child attributes

data.type

enum<string>

必須

注文の種類。watermark の注文は v2 と v3 のどちらで作成しても watermarkEmbed / watermarkExtract を返します

利用可能なオプション:

antiAi

data.orderId

string

必須

注文 ID

例:

"1001"

data.orderName

string | null

必須

注文名。v3 で作成した watermark 注文では表示用のファイル名を、なければ保存された名前を返します

data.channel

enum<string>

必須

注文チャネル

利用可能なオプション:

api,

web

data.status

enum<string>

必須

pending - アップロード待ち
inProgress - 処理中
complete - 完了。このときだけ result がオブジェクトです
failed - 失敗。理由は errors にあります
expired - ファイルの保管期限切れ。取得はできますが、result とすべての URL は null です

保存されたステータスが detected / undetected の v2 watermark 検出注文は complete を返し、判定は result.detectionStatus に入ります

利用可能なオプション:

pending,

inProgress,

complete,

failed,

expired

data.createdAt

string<date-time>

必須

作成日時

data.updatedAt

string<date-time>

必須

更新日時

data.expiresAt

string<date-time> | null

必須

ファイルの保管期限（UTC、ISO 8601）。整合性の例外でのみ null です

data.retentionDays

integer | null

必須

注文作成時に固定されたファイルの保管期間（日、7 または 30）。整合性の例外でのみ null です

例:

30

data.thumbnailImageUrl

string<uri> | null

必須

サムネイル画像の URL。取得元は注文の種類ごとのルールに従います。Anti-AI の注文と v2 の watermark 注文は未完了・失敗時に固定のステータス画像を、AI Detection の注文は詳細サムネイルまたは元の画像を、v3 の watermark 注文は詳細サムネイルを返し、処理前は null の場合があります

data.processingDelayed

boolean

必須

v3 で作成した watermark 注文が自動リトライを使い切り、手動復旧を待っているときに true です。注文は inProgress のままです。それ以外の注文では常に false です

data.errors

object | null

必須

失敗した注文のエラー情報で、それ以外は null です。v3 で作成した watermark 注文は公開用の errorCode と固定の案内文 errorMessage を返します。それ以外の注文は保存されたエラー情報をそのまま返し、errorCode がない場合があります

Hide child attributes

data.errors.errorCode

string

エラーコード。例: WATERMARK_FILE_CORRUPTED、ORDER_TIMEOUT、PROCESSING_ERROR

例:

"WATERMARK_FILE_CORRUPTED"

data.errors.errorMessage

string

エラーコードごとの固定の案内文（韓国語）。処理系の生の出力は含みません

data.inputFiles

object[]

必須

入力ファイルの一覧（リクエストの順）。ファイル数は inputFiles.length です。watermarkExtract の注文は PublicExtractInputFile（role あり）、それ以外の注文は PublicInputFile です

watermarkExtract 以外の注文の入力ファイル（リクエストの順）。role キーはありません。uploadUrl キーは注文の status が pending で、そのファイルがアップロード待ちのときだけ含まれ、それ以外はキー自体がありません（null にはなりません）

Option 1
Option 2

Hide child attributes

data.inputFiles.fileId

string

必須

入力ファイル ID。数字だけの文字列です

Pattern: ^[0-9]+$

例:

"11"

data.inputFiles.fileName

string | null

必須

入力ファイル名（拡張子を含む）。不明な場合は null です

例:

"cat.png"

data.inputFiles.uploadUrl

string<uri>

ファイルをアップロードするための presigned PUT URL。注文の status が pending で保管期限前、かつそのファイルがアップロード待ちのときだけ含まれます。アップロード済みのファイル、originalFileUrl で指定したファイル、pending ではない注文ではキーがありません

data.result

object | null

必須

Anti-AI の注文の結果。status が complete のときだけオブジェクトで、それ以外は null です

Hide child attributes

data.result.outputFiles

object[]

必須

結果ファイルの一覧。入力ファイルごとに結果が 1 件です

Hide child attributes

data.result.outputFiles.fileId

string

必須

結果ファイル ID。数字だけの文字列で、注文内で一意です

Pattern: ^[0-9]+$

例:

"21"

data.result.outputFiles.fileName

string | null

必須

結果ファイル名（拡張子を含む）。不明な場合は null です

例:

"cat.png"

data.result.outputFiles.inputFileId

string

必須

この結果の元になった入力ファイルの inputFiles[].fileId

Pattern: ^[0-9]+$

例:

"11"

概要

Anti-AI

AI Detection

Watermark-Embed

Watermark-Extract

Orders

レポート

Webhooks

注文詳細を取得

共通フィールド

ステータス

入力ファイル

注文の種類ごとの結果

例

以前のレスポンスからの変更

テストキー

承認

パスパラメータ

レスポンス

​共通フィールド

​ステータス

​入力ファイル

​注文の種類ごとの結果

​例

​以前のレスポンスからの変更

​テストキー

承認

パスパラメータ

レスポンス

共通フィールド

ステータス

入力ファイル

注文の種類ごとの結果

例

以前のレスポンスからの変更

テストキー