API reference / Feeds, search & Tako AI / Tako chat

Tako chat

A multi-turn conversation with Tako.

POSTapi.tikultra.com/v1/tako/chatPremium · 25 credits

Upstream: /aweme/v1/tako/op/stream/
Access: Every plan
Runs on: LeanPool · android · tiktok · 47.5.41
Client: os, app_flavour, app_version overrides
Billing: Failed calls are free

Authorization & parameters

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Body

Send JSON with content-type: application/json.

messagesobject[]required

The conversation so far, oldest first. For example [{"role":"user","content":"Best budget mechanical keyboards?"}].

regionstring

Two-letter country code for egress and storefront. For example US.

citystring

A city in that region. See the supported cities list. For example miami.

Client and egress

Optional. Leave them out to run as android · tiktok · 47.5.41 from the default LeanPool context. See Clients and versions.

osstring

android or ios. For example android.

app_flavourstring

Run as tiktok, lite, lite_coin, pro, studio, shop, tv, douyin. For example tiktok.

app_versionstring

A release of that app. Defaults to the current default for (os, app_flavour). For example 47.5.41.

regionstring

Two-letter country code for egress. For example US.

citystring

A supported city in that region. For example miami.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Response fields

Key top-level and nested fields decoded from the mobile upstream payload:

status_codeinteger

Upstream TikTok mobile status code (0 indicates success).

conversation_idstring

Full mobile IM conversation identifier.

message_idstring

Server-assigned IM message Snowflake ID.

replystring

Decoded reply value.

follow_upsstring[]

Decoded follow ups value.

cited_video_idsstring[]

List of cited video identifiers.

log_pbobject

Upstream request trace envelope from the mobile gateway.

log_pb.impr_idstring

Upstream TikTok impression / trace identifier.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.

import os from tikultra import TikUltra with TikUltra(api_key=os.environ["TIKULTRA_KEY"], region="US", city="miami") as client: res = client.request( "POST", "/v1/tako/chat", json_body={ "messages": [ { "role": "user", "content": "Best budget mechanical keyboards?", }, ], }, ) print(res.credits_cost, res.data)

{ "status_code": 0, "conversation_id": "tako_conv_918273645", "message_id": "tako_m2", "reply": "For quiet office typing, silent linear switches with a polycarbonate or POM plate keep acoustics below 45 dB.", "follow_ups": [ "Show sound test videos", "Best keycap profile for Mac?" ], "cited_video_ids": [ "7705852133855161377" ], "log_pb": { "impr_id": "202611120200419F8E7D6C5B4A3210" } }