curl --request POST \
--url https://api.apiyi.com/v1/responses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "dola-seed-2-1-turbo-260628",
"input": "Introduce yourself in one sentence"
}
'import requests
url = "https://api.apiyi.com/v1/responses"
payload = {
"model": "dola-seed-2-1-turbo-260628",
"input": "Introduce yourself in one sentence"
}
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: 'dola-seed-2-1-turbo-260628',
input: 'Introduce yourself in one sentence'
})
};
fetch('https://api.apiyi.com/v1/responses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.apiyi.com/v1/responses",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'dola-seed-2-1-turbo-260628',
'input' => 'Introduce yourself in one sentence'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.apiyi.com/v1/responses"
payload := strings.NewReader("{\n \"model\": \"dola-seed-2-1-turbo-260628\",\n \"input\": \"Introduce yourself in one sentence\"\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))
}HttpResponse<String> response = Unirest.post("https://api.apiyi.com/v1/responses")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"dola-seed-2-1-turbo-260628\",\n \"input\": \"Introduce yourself in one sentence\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.apiyi.com/v1/responses")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"dola-seed-2-1-turbo-260628\",\n \"input\": \"Introduce yourself in one sentence\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"status": "<string>",
"output": [
{}
],
"usage": {},
"caching": {}
}Seed 2.1 Turbo Responses API Reference
Seed 2.1 Turbo (dola-seed-2-1-turbo-260628) Responses API reference and interactive playground: native multi-turn previous_response_id and chained explicit caching.
curl --request POST \
--url https://api.apiyi.com/v1/responses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "dola-seed-2-1-turbo-260628",
"input": "Introduce yourself in one sentence"
}
'import requests
url = "https://api.apiyi.com/v1/responses"
payload = {
"model": "dola-seed-2-1-turbo-260628",
"input": "Introduce yourself in one sentence"
}
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: 'dola-seed-2-1-turbo-260628',
input: 'Introduce yourself in one sentence'
})
};
fetch('https://api.apiyi.com/v1/responses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.apiyi.com/v1/responses",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'dola-seed-2-1-turbo-260628',
'input' => 'Introduce yourself in one sentence'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.apiyi.com/v1/responses"
payload := strings.NewReader("{\n \"model\": \"dola-seed-2-1-turbo-260628\",\n \"input\": \"Introduce yourself in one sentence\"\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))
}HttpResponse<String> response = Unirest.post("https://api.apiyi.com/v1/responses")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"dola-seed-2-1-turbo-260628\",\n \"input\": \"Introduce yourself in one sentence\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.apiyi.com/v1/responses")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"dola-seed-2-1-turbo-260628\",\n \"input\": \"Introduce yourself in one sentence\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"status": "<string>",
"output": [
{}
],
"usage": {},
"caching": {}
}Bearer sk-your-api-key in Authorization, fill in input, and send. In the response output array, type: "reasoning" items are thinking summaries — type: "message" is the actual answer.id (resp_ prefix) as the next call’s previous_response_id — no need to resend history. Explicit caching and thinking control are covered in the Seed 2.1 Turbo Overview.- A small
max_output_tokensgets eaten by thinking, returningstatus: "incomplete"with empty text — start at 1500 - Explicit caching
caching: {"type": "enabled"}only hits when chained viaprevious_response_id; merely repeating the same prefix never hits (and disables the implicit prefix cache too)
Parameter Quick Reference
| Parameter | Type | Required | Default | Notes |
|---|---|---|---|---|
model | string | ✓ | — | Fixed: dola-seed-2-1-turbo-260628 |
input | string / array | ✓ | — | String or message array (including function_call_output items) |
max_output_tokens | int | — | Output budget including thinking; 1500+ recommended | |
reasoning.effort | string | — | low / medium / high; measured ~371 (low) vs ~1317 (high) reasoning tokens | |
previous_response_id | string | — | Previous response id for native multi-turn; enables full-context explicit cache hits | |
caching.type | string | disabled | enabled turns on explicit caching (requires chaining) | |
store | bool | true | Store this response for later reference | |
stream | bool | false | SSE event stream (response.created → response.completed) | |
text.format | object | — | Structured output, supports json_schema + strict | |
tools | array | — | Function-calling tool list (flat format) |
Response Highlights
- When
statusisincomplete, checkincomplete_details.reason(usuallylength: thinking ate the budget) - Thinking spend:
usage.output_tokens_details.reasoning_tokens - Cache hits:
usage.input_tokens_details.cached_tokens(chained turn 2 hit the full prior context in our tests, roughly halving latency) - The response
cachingfield echoes the cache mode actually in effect
Authorizations
API Key from the APIYI console
Body
Model ID, fixed to dola-seed-2-1-turbo-260628
dola-seed-2-1-turbo-260628 Input content. Either a string or a message array ([{role, content}, ...], including function_call_output items)
"Introduce yourself in one sentence"
Max output tokens (thinking included). Too small yields incomplete with empty text - use 1500+
Thinking depth control. Measured: effort low ~371, high ~1317 reasoning tokens
Show child attributes
Show child attributes
Previous response id (resp_ prefix) for native multi-turn; combine with caching.enabled for explicit cache hits
Explicit cache switch. enabled only hits when chained via previous_response_id
Show child attributes
Show child attributes
Whether to store this response for later previous_response_id reference
Stream via SSE (response.created → response.output_text.delta → response.completed)
Structured output. Supports {"format": {"type": "json_schema", name, strict, schema}}
Function-calling tool list (flat Responses format: {type, name, description, parameters})
Response
Generation succeeded. The output array contains reasoning and message items
Response ID (resp_ prefix), usable as the next turn's previous_response_id
completed / incomplete (incomplete when thinking eats the token budget)
Output items: reasoning (thinking summary), message (text), function_call, etc.
Usage. output_tokens_details.reasoning_tokens = thinking spend; input_tokens_details.cached_tokens = cache hits
The cache mode actually in effect for this request
Was this page helpful?