TOON Converter API 호출 방법

시작 전에

• 기본 URL: https://toonverter.com/api
• 모든 엔드포인트는 HTTPS + JSON
• 평가 한도는 여유롭고, 더 필요하면 연락 주세요

cURL 빠른 시작

curl https://toonverter.com/api/convert \
  -H "Content-Type: application/json" \
  -d '{
        "input_data": "{\"name\": \"Nova\", \"role\": \"moderator\"}",
        "direction": "json_to_toon"
      }'

파이썬 재시도 Helper

import requests
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry

session = requests.Session()
session.mount(
    "https://",
    HTTPAdapter(max_retries=Retry(total=3, backoff_factor=0.5)),
)

payload = {
    "input_data": "{\"session\": 42, \"status\": \"active\"}",
    "direction": "json_to_toon",
}
resp = session.post("https://toonverter.com/api/convert", json=payload, timeout=10)
resp.raise_for_status()
print(resp.json()["output"])

Node/Edge 함수 예시

import fetch from "node-fetch";

export async function convertJsonToToon(payload) {
  const response = await fetch("https://toonverter.com/api/convert", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      input_data: JSON.stringify(payload),
      direction: "json_to_toon",
    }),
  });

  if (!response.ok) {
    throw new Error(`TOON API error: ${response.status}`);
    }

  const data = await response.json();
  return data.output;
}

LLM에 전달하기 전 검증

/api/validate에 동일 payload를 보내 JSON/TOON 오류를 차단하세요. 응답이 가벼워 guardrail/CI용으로 적합합니다.

운영 팁

• API를 모니터링(지연 + 토큰 증감)으로 감싸기
• 아이템포턴시를 위해 변환 결과 캐싱
• UI 히스토리로 수동 QA 수행
• API 실패 시 JSON으로 롤백 같은 fallback 정의