AITF API Documentation

17 Products · 48 Endpoints · Agent-Ready Business Execution API

✍️ Content Engine

블로그, SNS, 이메일, 쇼츠, 뉴스레터를 7개 언어로 AI 생성합니다.

POST /v1/content/generate 콘텐츠 생성 ▼

설명

주제(topic)를 입력하면 AI가 지정된 타입과 언어로 콘텐츠를 생성합니다. 심리 트리거(손실회피, 사회적 증거 등)가 자동 적용됩니다.

파라미터

이름	타입	필수	설명
topic	string	✓	주제 또는 키워드
type	enum		blog, sns, email, shorts, newsletter, thread, all
language	string		ko, en, ja, zh, vi, th, es (기본: ko)

응답

필드	타입	설명
job_id	string	작업 고유 ID
content	object	생성된 콘텐츠
tokens_used	integer	사용 토큰 수

cURL

Python

Claude

curl -X POST https://aitf-api.onrender.com/v1/content/generate \ -H "Content-Type: application/json" \ -H "X-API-KEY: aitf_sk_your_key" \ -d '{ "topic": "바이브코딩 트렌드", "type": "blog", "language": "ko" }'

import requests resp = requests.post( "https://aitf-api.onrender.com/v1/content/generate", headers={"X-API-KEY": "aitf_sk_your_key"}, json={ "topic": "바이브코딩 트렌드", "type": "blog", "language": "ko" } ) print(resp.json())

# Claude / Cursor / Antigravity에게 이렇게 말하세요: "AITF API로 '바이브코딩 트렌드' 주제로 한국어 블로그 써줘" → AI가 자동으로 /v1/content/generate 호출 → SEO 최적화된 블로그 즉시 생성

응답 예시 (200 OK)

{ "job_id": "ct_a1b2c3d4", "content": { "title": "바이브코딩 트렌드: AI와 함께하는...", "body": "## 서론\n바이브코딩은...", "meta_description": "2026년 바이브코딩...", "tags": ["바이브코딩", "AI", "자동화"] }, "tokens_used": 1247 }

🛡️ Comment Shield

댓글 감성 분석 + AI 자동 답글 생성. 악성 댓글 필터링 포함.

POST /v1/comments/analyze 댓글 분석 ▶

파라미터

이름	타입	필수	설명
comments	string[]	✓	분석할 댓글 배열
platform	enum		youtube, instagram, blog, general

cURL

curl -X POST https://aitf-api.onrender.com/v1/comments/analyze \
  -H "X-API-KEY: aitf_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"comments":["최고!","별로.."],"platform":"youtube"}'

📝 Blog Publisher

키워드 하나로 SEO 최적화된 블로그를 자동 생성합니다. FAQ 스키마, 메타태그 포함.

POST /v1/blog/publish 블로그 자동 생성 ▶

이름	타입	필수	설명
keyword	string	✓	타겟 키워드
language	string		언어 (기본: ko)

curl -X POST https://aitf-api.onrender.com/v1/blog/publish \
  -H "X-API-KEY: aitf_sk_your_key" \
  -d '{"keyword":"AI 자동화","language":"ko"}'

📧 Email Sequence

7일 너처링 이메일 시퀀스를 AI로 생성합니다. 심리 트리거 자동 적용.

POST /v1/email/sequence 이메일 시퀀스 생성 ▶

이름	타입	필수	설명
product_name	string	✓	제품/서비스명
goal	enum		conversion, nurturing, onboarding, retention
days	integer		이메일 수 (기본: 7)

curl -X POST https://aitf-api.onrender.com/v1/email/sequence \
  -H "X-API-KEY: aitf_sk_your_key" \
  -d '{"product_name":"VibeCoding","goal":"conversion","days":7}'

🔑 Auth — API 키 발급

이메일만 입력하면 즉시 API 키를 발급받을 수 있습니다. 무료 플랜: 월 1,000건.

POST /v1/auth/register 무료 키 발급 ▶

이름	타입	필수	설명
email	string	✓	이메일 주소

응답

필드	설명
api_key	aitf_sk_로 시작하는 API 키
plan	free (1,000 calls/month)

curl -X POST https://aitf-api.onrender.com/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'

응답 (200)

{ "api_key": "aitf_sk_abc123def456...", "plan": "free", "limit": 1000, "message": "API key created" }

🔔 AI 알림 에이전트

AI가 심리 트리거 메시지를 작성하고, 알리고 SMS·Slack·Discord·Telegram·Webhook으로 즉시 발송. 후속 시퀀스 자동 등록까지 원스톱.

POST /v1/notify/compose AI 메시지 초안 A/B 2종 생성 ▶

이름	타입	필수	설명
situation	string	✓	알림 상황 설명 (2~300자)
brand_name	string	✓	브랜드명
target_desc	string	✓	수신 대상 설명
tone	string	-	friendly/urgent/formal/casual (기본: friendly)
max_chars	integer	-	최대 글자 수 (기본: 45)

curl -X POST https://aitf-api.onrender.com/v1/notify/compose \
  -H "X-API-KEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"situation":"구매 후 3일 미방문","brand_name":"JANDA","target_desc":"최근 구매 고객","tone":"friendly","max_chars":45}'

POST /v1/notify/send/sms 알리고 SMS 단건 발송 (90자 초과 → LMS 자동전환) ▶

이름	타입	필수	설명
to	string	✓	수신 번호 (하이픈 자동 제거)
msg	string	✓	발송 메시지 (90자 초과 시 LMS)
sender	string	-	발신 번호 (미입력 시 환경변수 사용)

curl -X POST https://aitf-api.onrender.com/v1/notify/send/sms \
  -H "X-API-KEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"01012345678","msg":"[JANDA] 오늘 방문 안 하시면 혜택이 사라져요!"}'

POST /v1/notify/slack Slack Incoming Webhook 발송 ▶

이름	타입	필수	설명
webhook_url	string	✓	https://hooks.slack.com/... URL
text	string	✓	메시지 본문 (max 2000자)
username	string	-	봇 이름 (기본: AITF Bot)
icon_emoji	string	-	이모지 (기본: :bell:)
channel	string	-	#channel (미지정 시 webhook 기본 채널)

curl -X POST https://aitf-api.onrender.com/v1/notify/slack \
  -H "X-API-KEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url":"https://hooks.slack.com/T.../B.../xxx","text":"배포 완료 ✅ v3.2 Render 반영됨","channel":"#dev-alerts"}'

POST /v1/notify/discord Discord Webhook 발송 (embed 지원) ▶

이름	타입	필수	설명
webhook_url	string	✓	https://discord.com/api/webhooks/... URL
content	string	✓	메시지 본문
embed_title	string	-	입력 시 embed 카드로 표시
embed_color	integer	-	embed 색상 (기본: 7340031 = #6C63FF)

curl -X POST https://aitf-api.onrender.com/v1/notify/discord \
  -H "X-API-KEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url":"https://discord.com/api/webhooks/...","content":"신규 가입자 발생","embed_title":"AITF 알림"}'

POST /v1/notify/webhook Generic HTTP POST — n8n / Zapier / Make ▶

이름	타입	필수	설명
url	string	✓	대상 URL (내부망 차단됨)
payload	object	-	전송할 JSON 바디
method	string	-	POST/PUT (기본: POST)
headers	object	-	커스텀 헤더
timeout_sec	integer	-	타임아웃 초 (1~30, 기본: 10)

curl -X POST https://aitf-api.onrender.com/v1/notify/webhook \
  -H "X-API-KEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://hook.n8n.cloud/webhook/xxx","payload":{"event":"new_signup","user":"ceo@janda.com"}}'

POST /v1/notify/telegram Telegram Bot 메시지 발송 ▶

이름	타입	필수	설명
bot_token	string	✓	Telegram Bot Token (숫자:문자열)
chat_id	string	✓	채팅 ID
message	string	✓	메시지 본문 (HTML/Markdown 지원)
parse_mode	string	-	HTML/Markdown/MarkdownV2 (기본: HTML)

curl -X POST https://aitf-api.onrender.com/v1/notify/telegram \
  -H "X-API-KEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bot_token":"123456:ABC-xxx","chat_id":"-100123456","message":"배포 완료 v3.2 반영됨 ✅"}'

POST /v1/notify/campaign 대량 SMS 캠페인 (최대 500명) ▶

이름	타입	필수	설명
name	string	✓	캠페인 이름
message	string	✓	발송 메시지 (max 90자)
recipients	array	✓	수신자 번호 목록 (최대 500명)
dry_run	boolean	-	true = 실발송 없이 대상 수 확인

curl -X POST https://aitf-api.onrender.com/v1/notify/campaign \
  -H "X-API-KEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"5월 프로모션","message":"[JANDA] 5월 한정 20% 할인!","recipients":["01011111111","01022222222"],"dry_run":true}'

POST /v1/notify/sequence 후속 알림 시퀀스 등록 ▶

이름	타입	필수	설명
name	string	✓	시퀀스 이름
trigger_type	string	✓	days_since_visit/post_purchase/cart_abandon/custom
steps	array	✓	[{day_offset, message, channel}] 발송 단계

curl -X POST https://aitf-api.onrender.com/v1/notify/sequence \
  -H "X-API-KEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"구매후 리뷰 요청","trigger_type":"post_purchase","steps":[{"day_offset":3,"message":"리뷰 남겨주세요!","channel":"sms"},{"day_offset":7,"message":"재방문 쿠폰 발송","channel":"sms"}]}'

GET /v1/notify/history 발송 이력 조회 (본인 이력만) ▶

이름	타입	필수	설명
limit	integer	-	조회 건수 (기본 50, 최대 200)

curl "https://aitf-api.onrender.com/v1/notify/history?limit=20" \
  -H "X-API-KEY: $API_KEY"

AITF API v3.2 — 18 Products · 57 Endpoints

Portal · Dashboard · Simulator · OpenAPI · llms.txt