Skip to main content
POST
/
dedicated
/
v1
/
detokenize
Detokenization
curl --request POST \
  --url https://api.friendli.ai/dedicated/v1/detokenize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "(endpoint-id)",
  "tokens": [
    128000,
    3923,
    374,
    1803,
    1413,
    15592,
    30
  ]
}
'
import requests

url = "https://api.friendli.ai/dedicated/v1/detokenize"

payload = {
    "model": "(endpoint-id)",
    "tokens": [128000, 3923, 374, 1803, 1413, 15592, 30]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({model: '(endpoint-id)', tokens: [128000, 3923, 374, 1803, 1413, 15592, 30]})
};

fetch('https://api.friendli.ai/dedicated/v1/detokenize', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.friendli.ai/dedicated/v1/detokenize"

	payload := strings.NewReader("{\n  \"model\": \"(endpoint-id)\",\n  \"tokens\": [\n    128000,\n    3923,\n    374,\n    1803,\n    1413,\n    15592,\n    30\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
{
  "text": "What is generative AI?"
}
Convert a list of token IDs back into text. To request successfully, it is mandatory to enter a Personal API Key (e.g. flp_XXX) value in the Bearer Token field. Refer to the authentication section on our introduction page to learn how to acquire this variable and visit here to generate your API Key.

Authorizations

​
Authorization
string
header
required

When using Friendli Suite API for inference requests, you need to provide a Friendli Token for authentication and authorization purposes.

For more detailed information, please refer here.

Headers

​
X-Friendli-Team
string | null

ID of team to run requests as (optional parameter).

Body

application/json
​
model
string
required

ID of target endpoint. If you want to send request to specific adapter, use the format "YOUR_ENDPOINT_ID:YOUR_ADAPTER_ROUTE". Otherwise, you can just use "YOUR_ENDPOINT_ID" alone.

Example:

"(endpoint-id)"

​
tokens
integer[]
required

A token sequence to detokenize.

Example:
[128000, 3923, 374, 1803, 1413, 15592, 30]

Response

Successfully detokenized the tokens.

​
text
string
required

Detokenized text output.

Last modified on June 9, 2026