External API Registration & Setup

KKAuto calls outside APIs for two kinds of work: producing content (AI Chat / AI Image) and making decisions (AI Decisions). Every provider needs an API key/token that you register and pay for directly with them.

Overview

Two different kinds of API

Kind	Used for	Configured at
AI Provider	Writing posts, writing comments, generating hashtags, generating descriptions, generating images	Setup Wizard (Step 1) or Automation settings > FB settings > AI Providers (/wtadmin/fb/settings/api)
AI Decisions	Very fast classification: should this post be engaged, should this group be joined, how should this comment be answered	Setup Wizard (Step 1) or AI Decisions (/wtadmin/fb/settings/api)
Captcha	Solving captchas automatically when a task hits a challenge	Automation settings > FB settings > Captcha (/wtadmin/fb/settings/captcha)

The recommended default pair

• DeepSeek for AI Provider — cheap, and deepseek-flash handles most Vietnamese content well.
• TypeSafe.ai (Jev) for AI Decisions — billed on input only, low latency, built for thousands of classifications per day.

You can use a different pair (OpenAI, Gemini, Claude, MiniMax). The requirement is simply that each kind has exactly one default configuration whose connection test passed.

The fastest path

Log in to the Management Website and open Setup Wizard:

1. Step 1: paste your DeepSeek and TypeSafe.ai tokens.
2. Step 2: describe your business so the AI drafts your shared instructions.
3. Step 3: review the generated hashtags with their descriptions and AI instructions.
4. Step 4: read the summary and start.

Everything below is only about getting tokens from each provider.

DeepSeek (recommended for AI Provider / AI Chat)

1. Create an account

1. Open platform.deepseek.com.
2. Sign up with email or phone and confirm the OTP code.

2. Top up

1. Open Top up in the account menu.
2. Pick an amount and pay. DeepSeek has no permanent free tier — an unfunded account fails every API call.

3. Create an API key

1. Open API Keys in the left menu.
2. Click Create new API key and give it a memorable name (for example kkauto-wtadmin).
3. Copy the key immediately — it is shown in full only once. Format: sk-....

4. Paste it into KKAuto

1. Open Setup Wizard → Step 1 → Enter API Token (AI Provider), or open Automation settings > FB settings > AI Providers (/wtadmin/fb/settings/api).
2. Choose provider DeepSeek, paste the key, pick a model:

Model	When to use
deepseek-flash	Default. Posts, comments, image reading (vision), hashtags — fastest and cheapest
deepseek-v4-pro	Needs deeper reasoning: long analysis, heavily constrained content

3. Click Test & Save — KKAuto makes one real call and reports a successful connection before you can set it as default.

TypeSafe.ai / Jev (recommended for AI Decisions)

TypeSafe.ai

AI Decisions answers short questions such as "is this post worth engaging with?" or "should we join this group?" — thousands of times a day. TypeSafe.ai returns a score or a choice instead of generating text, so:

• Billing is based on input volume, with no output cost to guess at.
• Latency is low and answers are never truncated mid-sentence.
• Train data (teaching by example) improves accuracy for your industry.

1. Create an account

1. Open typesafe.ai and sign up.
2. See the model catalog and limits at docs.typesafe.ai/models.

2. Create an API key

1. In the dashboard, open API Keys.
2. Create a new key and copy it immediately.

3. Paste it into KKAuto

1. Open Setup Wizard → Step 1 → Enter API Token (AI Decisions), or open AI Decisions under FB settings > API.
2. Choose TypeSafe.ai / Jev, paste the key, pick a model:

Model	When to use
jev-latest	Default. Use for every new configuration
jev-preview	Try new features. Do not use for production workloads

3. Click Test & Save. You can also click Preview to watch a single classification before setting it as default.

Limits to know

Each request carries at most 32,000 characters of state plus the longest question, and at most 20 questions per call. KKAuto trims long state before sending.

OpenAI (AI Chat, AI Image & OpenAI Decisions)

1. Create an account and add credit

1. Sign up at platform.openai.com.
2. Open Settings > Billing, add a payment method, and buy credit. An unfunded account returns insufficient_quota.

2. Create an API key

1. Open platform.openai.com/api-keys.
2. Click Create new secret key, name it, and copy the key (sk-...).

3. (Optional) Organization ID

If the key belongs to a specific organization, copy org-... from Settings > Organization > General and paste it into the Organization field in KKAuto. Leave it empty for personal accounts.

4. Where it goes in KKAuto

Role	Configured at	Suggested models
AI Chat	AI Providers	gpt-5.4-mini, gpt-4.1-mini, gpt-5.4
AI Image	AI Image Providers	gpt-image-2, gpt-image-1-mini
AI Decisions	AI Decisions	gpt-6-luna

Google Gemini (AI Chat & Vision)

1. Open Google AI Studio and sign in with a Google account.
2. Click Create API key and pick a project (or let Google create one).
3. Copy the key — format AIza....
4. Paste it into KKAuto under AI Providers, provider Gemini. Suggested models: gemini-3-flash (default, cheapest), gemini-2.5-flash, gemini-2.5-pro.

Gemini accepts image input on every model listed above, which helps when the AI must read a screenshot or a product photo.

Anthropic Claude (AI Chat & Vision)

1. Sign up at console.anthropic.com.
2. Open Settings > Billing and buy credit.
3. Open console.anthropic.com/settings/keys → Create Key and copy it (sk-ant-...).
4. Paste it into KKAuto under AI Providers, provider Claude. Suggested models: claude-haiku-4-5 (cheap and fast), claude-sonnet-4-6, claude-opus-4-6.

MiniMax (AI Chat & AI Image)

1. Sign up at platform.minimax.io.
2. Open API Keys, create a key, and copy it.
3. Paste it into KKAuto:

Role	Model
AI Chat	MiniMax-M3
AI Image	image-01 (aspect ratio is set separately, default 1:1)

CapSolver (automatic captcha solving)

1. Sign up at capsolver.com and add credit.
2. Open dashboard.capsolver.com, go to API Keys, and copy the key.
3. In KKAuto, open Automation settings > FB settings > Captcha (/wtadmin/fb/settings/captcha).
4. Add a service with provider capsolver, paste the key, click Test, then set it as default.

Captcha is only used when a task actually hits a challenge — no captcha configuration is needed for ordinary tasks.

After you have a token

• Every provider has a connection test. Only set a provider as default after the test passes.
• Keys are stored per tenant and visible only to the Super Admin and users with the FB settings permission.
• If a feature reports missing AI, go back to Setup Health to see which item is still incomplete.