# Autoke

> Autoke is an AI social media marketing service and API for generating social media content, then publishing it immediately or scheduling it across connected channels.

The website and developer documentation are available in Korean and English. Generated content can be requested in English, Korean, Japanese, Chinese, Spanish, French, German, Portuguese, Italian, Dutch, Russian, Arabic, Hindi, Indonesian, or Vietnamese.

- Production base URL: `https://autoke.ai`
- Public API version: `v3`
- Authentication: send an API key as `Authorization: Bearer ak_live_...`
- Request format: generation accepts JSON with `Content-Type: application/json`; publishing also accepts `multipart/form-data` for file uploads
- Generation endpoints return `{ "success": true, "data": ... }`; generated drafts are not published automatically
- Generation error responses return `{ "success": false, "error": { "code": HTTP_STATUS, "message": "..." } }`
- Supported publishing platforms: `x`, `facebook`, `instagram`, `threads`, `youtube`, and `tiktok`
- Before publishing, every target platform channel must be connected to the Autoke account or selected brand
- Instagram publishing requires at least one image or a video
- YouTube and TikTok require `videoURL` and complete user-selected `youtube` or `tiktok` upload options; these APIs upload existing videos, not generate videos
- YouTube is awaiting API audit approval: uploads remain private and channel access is being opened account by account; check the current OpenAPI introduction for availability. TikTok is generally available and honors the requested `privacyLevel`
- Use full English language names such as `Korean` or `English`, not `ko` or `en`, in generation requests
- For brand-aware post generation, pass `subuserID` explicitly; publishing defaults to the key's brand when `subuserID` is omitted
- Publishing responses have top-level `results` and `postIDs`, without a `data` wrapper; HTTP 200 can include platform failures, and `success` means at least one platform succeeded
- Scheduling success confirms a stored reservation, not delivery; `postIDs` are Autoke record IDs and can include failed publishing attempts
- Publishing validation errors may use `{ "message": "..." }`; inspect the HTTP status and response content type before parsing errors
- Before retrying a publishing request, check the existing results and calendar to avoid duplicate posts
- Post and bio generation each use 20 credits; image generation uses 300 credits
- Publishing or scheduling uses 100 credits per platform/post record, charged when the record is created; insufficient publishing credit can appear in `results[].error` with HTTP 200
- TikTok video URLs must come from Autoke uploads; use multipart `video` for external files. Video URL paths must end in `.mp4`, `.mov`, `.avi`, `.mkv`, or `.webm`
- Enable Auto Top-Up for automated or continuous generation to reduce failures caused by insufficient credits

Recommended workflow: create a draft with `POST /api/v3/generate-post`, review and edit `data.content`, then call `POST /api/v3/post-now` or `POST /api/v3/schedule-post`.

Public operations:

- `POST /api/v3/generate-post`: generate a platform-aware social media post draft
- `POST /api/v3/generate-image`: generate a new image or edit public reference images
- `POST /api/v3/generate-bio`: generate or rewrite a social media profile bio
- `POST /api/v3/post-now`: publish approved content to connected platform channels immediately
- `POST /api/v3/schedule-post`: schedule approved content for a future ISO 8601 date and time

## Start here

- [한국어 API 시작 안내](https://docs.autoke.ai/ko/api-docs.md): API 키 발급, 첫 요청, 요청·응답 예시, 게시 흐름, 크레딧과 오류 처리
- [English API quickstart](https://docs.autoke.ai/en/api-docs.md): API key setup, first request, request and response examples, publishing workflow, credits, and errors

## API reference

- [한국어 OpenAPI 3.1](https://docs.autoke.ai/openapi/ko.json): 요청·응답 모델, 필드 설명, 필수 조건, 지원 언어와 플랫폼을 포함한 기계 판독용 명세
- [English OpenAPI 3.1](https://docs.autoke.ai/openapi/en.json): Machine-readable operations, request and response models, field descriptions, constraints, languages, and platforms

## Account and credits

- [오토케 계정](https://autoke.ai/ko/account): API 키를 발급하고 브랜드별 연결 채널을 관리하는 한국어 계정 화면
- [Autoke account](https://autoke.ai/en/account): Create API keys and manage connected channels for each brand in English
- [오토케 결제 및 크레딧](https://autoke.ai/ko/billing): 크레딧 잔액, 추가 충전, 자동 충전 설정
- [Autoke billing and credits](https://autoke.ai/en/billing): Credit balance, credit purchases, and Auto Top-Up settings

## Optional

- [한국어 대화형 API 문서](https://docs.autoke.ai/ko): Scalar 기반 요청 실험 화면과 한국어 모델 탐색기
- [English interactive API documentation](https://docs.autoke.ai/en): Scalar request testing interface and English model explorer
- [오토케 제품 소개](https://autoke.ai/ko): 한국어 제품 개요
- [Autoke product overview](https://autoke.ai/en): English product overview
- [개인정보처리방침](https://autoke.ai/ko/privacy-policy): 한국어 개인정보 처리 기준
- [이용약관](https://autoke.ai/ko/terms-of-service): 한국어 서비스 이용 조건