AI APIAPI

실제로 호출하는 방식 그대로 제공되는 AI 글쓰기

REST 엔드포인트 하나가 브리프에서 캡션을 생성해요. 초안을 네트워크별로 다시 쓰고 URL을 재활용하는 나머지 글쓰기 도구는 FoPost MCP 서버에 있어, AI 클라이언트가 바로 예약까지 연결할 수 있어요.

POST /v1/ai/generate-caption
curl -X POST https://api.fopost.com/v1/ai/generate-caption \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "instructions": "Announce webhook retries with exponential backoff. Keep it direct.",
    "platforms": ["linkedin"]
  }'

REST 엔드포인트 하나

generate-caption은 브리프와 대상 플랫폼을 받아 바로 쓸 수 있는 문구를 반환해요.

MCP 도구 세 가지

모든 MCP 클라이언트에서 쓸 수 있는 generate_caption, rewrite_for_platforms, repurpose_url.

크레딧 기반

모든 호출은 워크스페이스의 AI 크레딧에서 차감돼요. 잔액은 언제든 확인할 수 있어요.

REST

자체 파이프라인에서 캡션 생성

짧은 브리프와 대상 네트워크를 보내면 해당 네트워크의 제한에 맞춰 작성된 캡션을 받아요. 키에 ai 범위가 필요해요. 응답은 텍스트이며, 직접 POST /v1/posts로 넘기기 전까지는 아무것도 게시되지 않아요.

AI 레퍼런스 읽기
응답
{
  "caption": "Webhook retries are live. A failed delivery now retries with exponential backoff before it ever reaches your inbox as an error. Details in the changelog.",
  "credits": { "charged": 1, "remaining": 199 }
}

플랫폼 맞춤

길이, 해시태그 사용, 줄바꿈이 지정한 네트워크에 맞춰져요.

자동 게시 없음

엔드포인트는 텍스트를 반환해요. 게시는 별도의 명시적인 요청이에요.

ai 범위

크레딧을 사용해야 하는 키에만 부여하세요.

MCP

AI 클라이언트에서 다시 쓰기와 재활용

MCP 서버는 전체 글쓰기 도구를 제공해요. rewrite_for_platforms는 초안 하나를 X용 스레드와 LinkedIn용 단락으로 바꿔요. repurpose_url은 페이지를 읽고 게시물 시리즈를 제안해요. 두 도구 모두 같은 세션에서 결과를 schedule_post로 넘기며, 게시 전에 클라이언트가 확인을 요청해요.

MCP 서버 설정하기
프롬프트
> Take our latest changelog at https://yourbrand.com/changelog
  and turn it into three posts for LinkedIn and X this week.

Agent: I'll call repurpose_url, then rewrite_for_platforms for each,
then schedule_post for Tue, Wed, and Thu at 9am. Proceed? (y/n)

rewrite_for_platforms

초안 하나를 넣으면 네트워크별 버전이 각 제한에 맞춰 나와요.

repurpose_url

게시물, 변경 로그, 문서 페이지를 지정하면 시리즈를 돌려받아요.

바로 예약까지

에이전트가 채팅을 벗어나지 않고 글쓰기 도구를 schedule_post로 연결해요.

크레딧

사용량은 투명하고, 상한이 있으며, 워크스페이스별로

모든 AI 호출은 모든 계정에 포함된 월간 무료 사용 크레딧에서 차감돼요. 잔액은 MCP의 get_ai_credits로, 대시보드에서는 AI 사용량에서 확인하세요. 잔액이 소진되면 조용히 실패하지 않고 업그레이드 링크와 함께 402를 반환해요.

개발 시작하기
저장된 브랜드 보이스로 여러 네트워크용 게시물 초안을 작성하는 에이전트

get_ai_credits

대량 작업 전에 에이전트에게 남은 크레딧을 물어보세요.

명확한 402

잔액 소진은 명시적인 오류로 처리되며, 절반만 작성된 게시물은 생기지 않아요.

워크스페이스 범위

크레딧과 프롬프트는 키가 속한 워크스페이스 안에만 머물러요.

AI API에 대해 자주 묻는 질문

REST API에는 어떤 AI 기능이 있나요?

ai 범위가 필요한 엔드포인트 POST /v1/ai/generate-caption 하나예요. 네트워크별 다시 쓰기, 해시태그 제안, URL 재활용은 현재 공개 REST 엔드포인트가 아니라 MCP 도구와 앱 내 에이전트에서 사용할 수 있어요.

어떤 모델을 사용하나요?

FoPost는 제공업체나 모델을 공개하지 않아요. 기능과 톤을 고르면 서비스가 실행할 모델을 선택하며, 사용자 측 변경 없이 바꿀 수 있어요.

스스로 게시하나요?

아니요. 모든 AI 엔드포인트와 도구는 텍스트를 반환해요. 게시는 별도의 요청이고, MCP 클라이언트는 schedule_post 호출을 실행하기 전에 승인을 받도록 보여 줘요.

크레딧은 어떻게 청구되나요?

각 호출은 결제 계정에 계량되며 응답과 함께 반환돼요. 사용량은 먼저 월간 무료 크레딧에서 차감되고, 카드가 등록되어 있으면 초과분은 사용한 만큼만 정확히 청구돼요.

제 브랜드 보이스를 알고 있나요?

앱 내 에이전트에서 호출할 때 브랜드를 첨부하면 그 보이스와 스타일이 프롬프트에 반영돼요. REST 엔드포인트는 brand_voice_id를 받거나 워크스페이스 기본 브랜드를 사용하며, 보낸 브리프도 함께 반영해요.

키에 어떤 범위가 필요한가요?

ai 범위예요. 이 범위가 없는 키는 이 엔드포인트에서 403을 받지만, 가진 다른 범위에 대해서는 정상적으로 작동해요.

오늘 바로 AI API로 개발하세요

무료로 시작할 수 있고 전체 API가 포함돼요. 키를 만들고 몇 분 만에 첫 호출을 해 보세요.

API 키 받기