Messages

curl --request POST \
  --url https://api.tikway.ai/v1/messages \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "You are a helpful assistant.",
  "messages": [
    {
      "role": "user",
      "content": "Write a short bedtime story about a unicorn."
    }
  ]
}
'

{
  "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
  "container": {
    "id": "container_011CpZohnwH4vuy7gazohgSP",
    "expires_at": "2019-12-27T18:11:19.117Z",
    "skills": [
      {
        "skill_id": "pdf",
        "type": "anthropic",
        "version": "latest"
      }
    ]
  },
  "content": [
    {
      "citations": [
        {
          "cited_text": "The grass is green. The sky is blue.",
          "document_index": 0,
          "document_title": "My Document",
          "end_char_index": 0,
          "file_id": "file_011CNha8iCJcU1wXNR6q4V8w",
          "start_char_index": 0,
          "type": "char_location"
        }
      ],
      "text": "Hi! My name is Claude.",
      "type": "text"
    }
  ],
  "context_management": {
    "applied_edits": [
      {
        "cleared_input_tokens": 0,
        "cleared_tool_uses": 0,
        "type": "clear_tool_uses_20250919"
      }
    ]
  },
  "diagnostics": {
    "cache_miss_reason": {
      "cache_missed_input_tokens": 0,
      "type": "model_changed"
    }
  },
  "model": "claude-opus-5",
  "role": "assistant",
  "stop_details": {
    "category": "cyber",
    "explanation": "This request was declined because it conflicts with Anthropic's Usage Policy.",
    "fallback_credit_token": "QW50aHJvcGljL0NsYXVkZQ==",
    "fallback_has_prefill_claim": true,
    "recommended_model": "claude-opus-4-8",
    "type": "refusal"
  },
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "type": "message",
  "usage": {
    "cache_creation": {
      "ephemeral_1h_input_tokens": 0,
      "ephemeral_5m_input_tokens": 0
    },
    "cache_creation_input_tokens": 2051,
    "cache_read_input_tokens": 2051,
    "fallback_credit": {
      "status": {
        "type": "redeemed"
      }
    },
    "inference_geo": "global",
    "input_tokens": 2095,
    "iterations": [
      {
        "cache_creation": {
          "ephemeral_1h_input_tokens": 0,
          "ephemeral_5m_input_tokens": 0
        },
        "cache_creation_input_tokens": 0,
        "cache_read_input_tokens": 0,
        "input_tokens": 0,
        "model": "claude-fable-5-1",
        "output_tokens": 0,
        "type": "message"
      }
    ],
    "output_tokens": 503,
    "output_tokens_details": {
      "thinking_tokens": 0
    },
    "server_tool_use": {
      "web_fetch_requests": 2,
      "web_search_requests": 0
    },
    "service_tier": "standard",
    "speed": "standard"
  },
  "input_transformations": [
    {
      "path": "path",
      "reason": "model_binding_mismatch",
      "type": "thinking_dropped"
    }
  ]
}

POST

https://api.tikway.ai

messages

curl --request POST \
  --url https://api.tikway.ai/v1/messages \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "You are a helpful assistant.",
  "messages": [
    {
      "role": "user",
      "content": "Write a short bedtime story about a unicorn."
    }
  ]
}
'

{
  "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
  "container": {
    "id": "container_011CpZohnwH4vuy7gazohgSP",
    "expires_at": "2019-12-27T18:11:19.117Z",
    "skills": [
      {
        "skill_id": "pdf",
        "type": "anthropic",
        "version": "latest"
      }
    ]
  },
  "content": [
    {
      "citations": [
        {
          "cited_text": "The grass is green. The sky is blue.",
          "document_index": 0,
          "document_title": "My Document",
          "end_char_index": 0,
          "file_id": "file_011CNha8iCJcU1wXNR6q4V8w",
          "start_char_index": 0,
          "type": "char_location"
        }
      ],
      "text": "Hi! My name is Claude.",
      "type": "text"
    }
  ],
  "context_management": {
    "applied_edits": [
      {
        "cleared_input_tokens": 0,
        "cleared_tool_uses": 0,
        "type": "clear_tool_uses_20250919"
      }
    ]
  },
  "diagnostics": {
    "cache_miss_reason": {
      "cache_missed_input_tokens": 0,
      "type": "model_changed"
    }
  },
  "model": "claude-opus-5",
  "role": "assistant",
  "stop_details": {
    "category": "cyber",
    "explanation": "This request was declined because it conflicts with Anthropic's Usage Policy.",
    "fallback_credit_token": "QW50aHJvcGljL0NsYXVkZQ==",
    "fallback_has_prefill_claim": true,
    "recommended_model": "claude-opus-4-8",
    "type": "refusal"
  },
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "type": "message",
  "usage": {
    "cache_creation": {
      "ephemeral_1h_input_tokens": 0,
      "ephemeral_5m_input_tokens": 0
    },
    "cache_creation_input_tokens": 2051,
    "cache_read_input_tokens": 2051,
    "fallback_credit": {
      "status": {
        "type": "redeemed"
      }
    },
    "inference_geo": "global",
    "input_tokens": 2095,
    "iterations": [
      {
        "cache_creation": {
          "ephemeral_1h_input_tokens": 0,
          "ephemeral_5m_input_tokens": 0
        },
        "cache_creation_input_tokens": 0,
        "cache_read_input_tokens": 0,
        "input_tokens": 0,
        "model": "claude-fable-5-1",
        "output_tokens": 0,
        "type": "message"
      }
    ],
    "output_tokens": 503,
    "output_tokens_details": {
      "thinking_tokens": 0
    },
    "server_tool_use": {
      "web_fetch_requests": 2,
      "web_search_requests": 0
    },
    "service_tier": "standard",
    "speed": "standard"
  },
  "input_transformations": [
    {
      "path": "path",
      "reason": "model_binding_mismatch",
      "type": "thinking_dropped"
    }
  ]
}

授权

x-api-key

string

header

必填

Tikway API Key。按 Anthropic 原生协议通过 x-api-key 请求头传递。

请求体

application/json

model

string

必填

用于生成消息的 Claude 模型 ID，例如 claude-opus-5。

max_tokens

integer

必填

生成内容的最大词元数。模型可在达到上限前停止；设为 0 可仅预热提示词缓存而不生成回复。

必填范围: x >= 0

messages

object[]

必填

输入对话消息。模型按 user 与 assistant 轮次工作；连续同角色消息会合并。没有 system 角色，系统提示词请使用顶层 system。

Maximum array length: 100000

Hide child attributes

messages.role

enum<string>

必填

消息角色。最后一条为 assistant 时，模型会从其内容继续生成。

可用选项:

user,

assistant

messages.content

必填

消息内容。字符串等价于只含一个 text 内容块的数组。

system

系统提示词。Messages API 不支持 system 角色消息，应使用此字段。

stream

boolean

是否以 Server-Sent Events 流式返回消息事件。

stop_sequences

string[]

自定义停止序列；模型生成到任一序列时停止。

temperature

number

采样温度。较高值使输出更随机；通常与 top_p、top_k 二选一调整。

必填范围: 0 <= x <= 1

top_p

number

核采样阈值。

必填范围: 0 <= x <= 1

top_k

integer

每步采样时保留的最高概率候选词元数。

必填范围: x >= 0

thinking

object

扩展思考配置。启用思考时，预算词元会计入 max_tokens。

Hide child attributes

thinking.type

enum<string>

思考模式。

可用选项:

enabled,

adaptive,

disabled

thinking.budget_tokens

integer

enabled 模式下的思考词元预算。

必填范围: x >= 1

tools

object[]

可供 Claude 调用的工具定义。

Hide child attributes

tools.name

string

工具名称。

tools.description

string

工具用途说明。

tools.input_schema

object

工具输入参数的 JSON Schema。

tools.type

string

工具类型；自定义工具通常为 custom 或省略。

tools.cache_control

object

Hide child attributes

tools.cache_control.type

enum<string>

可用选项:

ephemeral

tools.cache_control.ttl

enum<string>

可用选项:

5m,

1h

tool_choice

object

控制 Claude 是否及如何选择工具。

Hide child attributes

tool_choice.type

enum<string>

工具选择模式。

可用选项:

auto,

any,

tool,

none

tool_choice.name

string

type 为 tool 时强制调用的工具名称。

tool_choice.disable_parallel_tool_use

boolean

是否禁止并行工具调用。

output_config

object

输出配置。

Hide child attributes

output_config.effort

enum<string>

输出推理/质量投入级别。

可用选项:

low,

medium,

high

output_config.format

object

结构化输出格式。

Hide child attributes

output_config.format.type

enum<string>

可用选项:

json_schema

output_config.format.schema

object

目标 JSON Schema。

output_format

object

JSON 输出格式配置。

Hide child attributes

output_format.type

enum<string>

可用选项:

json_schema

output_format.schema

object

目标 JSON Schema。

metadata

object

请求元数据。

Hide child attributes

metadata.user_id

string

终端用户标识。

service_tier

enum<string>

服务层级选择。

可用选项:

auto,

standard_only

speed

enum<string>

推理速度模式。

可用选项:

standard,

fast

container

代码执行容器配置或容器 ID。

context_management

object

上下文管理配置。

mcp_servers

object[]

MCP 服务器定义。

Hide child attributes

mcp_servers.name

string

mcp_servers.url

string

mcp_servers.authorization_token

string

cache_control

object

请求级提示词缓存控制。

Hide child attributes

cache_control.type

enum<string>

可用选项:

ephemeral

cache_control.ttl

enum<string>

可用选项:

5m,

1h

diagnostics

object

诊断信息配置。

fallback_credit_token

回退服务抵扣令牌。

fallbacks

object

模型回退配置。

inference_geo

string

推理地域偏好。

响应

200 - application/json

string

必填

消息唯一 ID。

type

enum<string>

必填

对象类型，固定为 message。

可用选项:

message

role

enum<string>

必填

消息角色，固定为 assistant。

可用选项:

assistant

model

string

必填

实际使用的 Claude 模型 ID。

content

object[]

必填

Claude 生成的内容块列表。

Hide child attributes

content.type

enum<string>

必填

输出内容块类型。

可用选项:

text,

thinking,

redacted_thinking,

tool_use,

server_tool_use,

web_search_tool_result,

web_fetch_tool_result,

code_execution_tool_result

content.text

string

text 内容块的生成文本。

content.citations

object[]

文本引用列表。

Hide child attributes

content.citations.type

string

引用类型。

content.citations.cited_text

string

被引用文本。

content.citations.document_index

integer

源文档索引。

content.citations.document_title

string

源文档标题。

content.citations.start_char_index

integer

content.citations.end_char_index

integer

content.citations.url

string

content.citations.title

string

content.thinking

string

扩展思考文本。

content.signature

string

思考内容签名；下轮回传时必须保持原样。

content.data

string

redacted_thinking 的加密数据。

content.id

string

工具调用 ID。

content.name

string

被调用工具名称。

content.input

object

工具调用输入参数。

content.content

any

服务器工具调用结果内容。

content.tool_use_id

string

关联的工具调用 ID。

content.is_error

boolean

服务器工具结果是否出错。

stop_reason

enum<string>

必填

生成停止原因。

可用选项:

end_turn,

max_tokens,

stop_sequence,

tool_use,

pause_turn,

refusal,

model_context_window_exceeded

usage

object

必填

计费与限流词元使用统计。

Hide child attributes

usage.input_tokens

integer

必填

输入词元数。

必填范围: x >= 0

usage.output_tokens

integer

必填

输出词元数。

必填范围: x >= 0

usage.cache_creation_input_tokens

integer

创建缓存所用输入词元数。

必填范围: x >= 0

usage.cache_read_input_tokens

integer

从缓存读取的输入词元数。

必填范围: x >= 0

usage.cache_creation

object

Hide child attributes

usage.cache_creation.ephemeral_5m_input_tokens

integer

usage.cache_creation.ephemeral_1h_input_tokens

integer

usage.output_tokens_details

object

Hide child attributes

usage.output_tokens_details.thinking_tokens

integer

思考词元数。

usage.server_tool_use

object

Hide child attributes

usage.server_tool_use.web_search_requests

integer

usage.server_tool_use.web_fetch_requests

integer

usage.service_tier

enum<string>

实际服务层级。

可用选项:

standard,

priority,

batch

usage.speed

enum<string>

实际推理速度。

可用选项:

standard,

fast

stop_sequence

string

若因自定义停止序列结束，则为命中的序列。

stop_details

object

拒绝等停止情况的结构化信息。

Hide child attributes

stop_details.type

string

stop_details.category

string

stop_details.explanation

string

stop_details.recommended_model

string

container

object

代码执行容器信息。

Hide child attributes

container.id

string

container.expires_at

string

容器过期时间。

container.skills

string[]

context_management

object

服务端应用的上下文管理结果。

diagnostics

object

诊断信息，例如缓存未命中原因。

input_transformations

object[]

API 对输入应用的变换，例如被丢弃的思考块。

Hide child attributes

input_transformations.type

enum<string>

可用选项:

thinking_dropped

input_transformations.path

string

input_transformations.reason

enum<string>

可用选项:

model_binding_mismatch,

prefix_binding_mismatch,

organization_binding_mismatch,

end_user_binding_mismatch

对话补全

图片生成

视频生成

向量嵌入

语音转写

授权

请求体

响应