curl -X POST https://api.bizmori.com/api/v2/orders/anti-ai \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"idempotencyKey": "2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40",
"files": [
{"fileName": "image1.jpg"},
{"fileName": "image2.png"}
],
"options": {"strength": "high"}
}'const response = await fetch('https://api.bizmori.com/api/v2/orders/anti-ai', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
idempotencyKey: '2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40',
files: [
{ fileName: 'image1.jpg' },
{ fileName: 'image2.png' }
],
options: { strength: 'high' }
})
});
const data = await response.json();import requests
response = requests.post(
'https://api.bizmori.com/api/v2/orders/anti-ai',
headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
json={
'idempotencyKey': '2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40',
'files': [
{'fileName': 'image1.jpg'},
{'fileName': 'image2.png'}
],
'options': {'strength': 'high'}
}
)
data = response.json()<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bizmori.com/api/v2/orders/anti-ai",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'idempotencyKey' => '2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40',
'files' => [
[
'fileName' => 'image1.jpg'
],
[
'fileName' => 'image2.png'
]
],
'options' => [
'strength' => 'high'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bizmori.com/api/v2/orders/anti-ai"
payload := strings.NewReader("{\n \"idempotencyKey\": \"2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40\",\n \"files\": [\n {\n \"fileName\": \"image1.jpg\"\n },\n {\n \"fileName\": \"image2.png\"\n }\n ],\n \"options\": {\n \"strength\": \"high\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bizmori.com/api/v2/orders/anti-ai")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"idempotencyKey\": \"2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40\",\n \"files\": [\n {\n \"fileName\": \"image1.jpg\"\n },\n {\n \"fileName\": \"image2.png\"\n }\n ],\n \"options\": {\n \"strength\": \"high\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bizmori.com/api/v2/orders/anti-ai")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"idempotencyKey\": \"2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40\",\n \"files\": [\n {\n \"fileName\": \"image1.jpg\"\n },\n {\n \"fileName\": \"image2.png\"\n }\n ],\n \"options\": {\n \"strength\": \"high\"\n }\n}"
response = http.request(request)
puts response.read_body{
"data": {
"orderName": "anti_ai_2026-02-09",
"orderId": "123456789",
"status": "pending",
"files": [
{
"fileId": 1,
"fileName": "image1.jpg",
"uploadUrl": "https://s3.amazonaws.com/...",
"fileKey": "temp/123456789/0/image1.jpg"
}
]
}
}Anti-AI 주문 생성
AI 감지 방지 처리를 위한 주문을 생성합니다.
입력 모드 (업로드 / URL / 혼합)
입력 모드는 각 파일 객체에 originalFileUrl 포함 여부로 결정됩니다:
- 업로드 모드 (
originalFileUrl없음): 프리사인드 URL 발급 → 클라이언트가 S3에 업로드 →/confirm호출 - URL 모드 (
originalFileUrl제공): URL에서 이미지를 다운로드하여 즉시 처리 - 혼합 모드: 일부 파일은 업로드 모드, 나머지는 URL 모드로 동시 처리
동작 방식
| 조건 | 주문 상태 | Confirm 필요 |
|---|---|---|
모든 파일에 originalFileUrl 있음 | inProgress | 불필요 (즉시 처리) |
originalFileUrl 없는 파일 포함 | pending | 필요 (업로드 후 confirm) |
Zero Copy 모드
mode.zeroCopy: true로 설정하면, 처리 결과가 고객이 제공한 프리사인드 URL로 직접 업로드됩니다.
이 경우 outputTargets 배열이 필수이며 files 배열과 동일한 길이여야 합니다.
curl -X POST https://api.bizmori.com/api/v2/orders/anti-ai \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"idempotencyKey": "2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40",
"files": [
{"fileName": "image1.jpg"},
{"fileName": "image2.png"}
],
"options": {"strength": "high"}
}'const response = await fetch('https://api.bizmori.com/api/v2/orders/anti-ai', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
idempotencyKey: '2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40',
files: [
{ fileName: 'image1.jpg' },
{ fileName: 'image2.png' }
],
options: { strength: 'high' }
})
});
const data = await response.json();import requests
response = requests.post(
'https://api.bizmori.com/api/v2/orders/anti-ai',
headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
json={
'idempotencyKey': '2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40',
'files': [
{'fileName': 'image1.jpg'},
{'fileName': 'image2.png'}
],
'options': {'strength': 'high'}
}
)
data = response.json()<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bizmori.com/api/v2/orders/anti-ai",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'idempotencyKey' => '2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40',
'files' => [
[
'fileName' => 'image1.jpg'
],
[
'fileName' => 'image2.png'
]
],
'options' => [
'strength' => 'high'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bizmori.com/api/v2/orders/anti-ai"
payload := strings.NewReader("{\n \"idempotencyKey\": \"2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40\",\n \"files\": [\n {\n \"fileName\": \"image1.jpg\"\n },\n {\n \"fileName\": \"image2.png\"\n }\n ],\n \"options\": {\n \"strength\": \"high\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bizmori.com/api/v2/orders/anti-ai")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"idempotencyKey\": \"2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40\",\n \"files\": [\n {\n \"fileName\": \"image1.jpg\"\n },\n {\n \"fileName\": \"image2.png\"\n }\n ],\n \"options\": {\n \"strength\": \"high\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bizmori.com/api/v2/orders/anti-ai")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"idempotencyKey\": \"2f4b6c82-8a6e-4f39-9f8a-7d3b5c1e2a40\",\n \"files\": [\n {\n \"fileName\": \"image1.jpg\"\n },\n {\n \"fileName\": \"image2.png\"\n }\n ],\n \"options\": {\n \"strength\": \"high\"\n }\n}"
response = http.request(request)
puts response.read_body{
"data": {
"orderName": "anti_ai_2026-02-09",
"orderId": "123456789",
"status": "pending",
"files": [
{
"fileId": 1,
"fileName": "image1.jpg",
"uploadUrl": "https://s3.amazonaws.com/...",
"fileKey": "temp/123456789/0/image1.jpg"
}
]
}
}sk_test_ 키를 사용하면 테스트 API 키에 설명된 테스트 주문 흐름을 따릅니다. 테스트 업로드는 응답의 BIZ MORI 업로드 URL을 사용하며 결과 파일은 만들지 않습니다.주문 결과 다운로드
주문이complete 상태가 되면 다운로드 URL 발급 엔드포인트를 사용하여 처리된 파일을 다운로드할 수 있습니다:
curl -X GET https://api.bizmori.com/api/v2/orders/{orderId}/download \
-H "Authorization: Bearer YOUR_API_TOKEN"
sk_test_ 주문은 결과 파일을 만들지 않으므로 다운로드 요청이 404 PROCESSED_FILE_NOT_FOUND를 반환합니다.인증
외부 클라이언트 접근을 위한 Bearer API 키. 일반 키는 sk_ 접두사를 사용하고, 테스트 키는 sk_test_ 접두사로 모의 응답을 사용해 실제 처리나 크레딧 사용 없이 주문 흐름을 검증합니다.
본문
중복 요청 방지를 위한 멱등성 키
주문 이름 (미입력 시 자동 생성)
64응답
주문 생성 성공
Hide child attributes
Hide child attributes
주문 상태
pending: 업로드 파일 포함 (confirm 필요)inProgress: 모든 파일이 URL 모드 (즉시 처리)
pending, inProgress Hide child attributes
Hide child attributes
파일 ID
파일 이름
업로드 URL — 업로드 모드 파일만 해당. live 키는 S3 presigned URL을 받고, 테스트 키는 절대 https://api.bizmori.com/api/v2/test-uploads/{signedToken} URL을 받습니다. 두 URL은 1시간 후 만료되며 POST /api/v2/orders/{orderId}/refresh-urls로 재발급할 수 있습니다. signed token 자체가 테스트 업로드를 인가하므로 PUT에 Authorization 헤더가 필요 없습니다. 테스트 요청 본문은 스트림으로 소비되어 저장되지 않으며, 테스트 주문은 사용량 차감이나 실제 외부 처리 없이 모의 결과로 전이합니다.
파일 식별자 — 업로드 모드 파일만 해당: live 키에서는 S3 object key이고 테스트 키에서는 격리된 logical key입니다.
원본 이미지 URL — URL 모드 파일만 해당