Reference

Generations

A Generation is one Sylphx AI inference call of a project environment (Responses, Messages, Chat Completions, embeddings, images, audio),…

Checked 2026-09-28

A Generation is one Sylphx AI inference call of a project environment (Responses, Messages, Chat Completions, embeddings, images, audio), read from the OpenTelemetry GenAI span the AI gateway emits for it. It is a view over the environment's traces, so it has no store of its own and expires with them. It never names how the call was served: no route, account or vendor endpoint, and no cost other than the price the caller was charged. Prompts and outputs are not here. The id is the span id.

Service Sylphx Observability · Resource type observability.sylphx.com/Generation · Name pattern orgs/{org}/projects/{project}/envs/{env}/generations/{generation} · Shape record

#Fields

Field	Type	What it is
name	string	orgs/{org}/projects/{project}/envs/{env}/generations/{generation}.
uid	string	gen_<cell><ulid>; never reused. Output only.
meta	ResourceMeta	Resource metadata.
trace_id	string	The W3C trace id (32 hex); the caller's own when it sent traceparent. Output only.
span_id	string	The W3C span id (16 hex) of the gateway's span. Output only.
operation	string	gen_ai.operation.name, for example chat, embeddings or generate_content. Output only.
api_surface	string	The wire the call used: responses, messages, chat_completions, embeddings, images, audio or realtime_transcription. Output only.
request_model	string	The catalogue model id the caller named, for example anthropic/claude-sonnet-5.5. Output only.
response_model	string	The catalogue model id that answered. Output only.
response_id	string	The response id (resp_..., msg_... or chatcmpl-...). Output only.
api_key	string	The key that made the call, as a resource name. Output only.
outcome	GenerationOutcome	How the call ended. Output only. One of succeeded, failed, cancelled.
finish_reasons	string[]	gen_ai.response.finish_reasons, for example stop or length. Output only.
error_type	string	error.type when the call failed: the public error code, for example rate_limited. Output only.
input_tokens	int64	Input tokens, cached ones included. Output only.
output_tokens	int64	Output tokens, reasoning ones included. Output only.
cache_read_input_tokens	int64	Input tokens read from the prompt cache. Output only.
cache_write_input_tokens	int64	Input tokens written to the prompt cache. Output only.
reasoning_output_tokens	int64	Output tokens spent on reasoning. Output only.
price_usd	string	What the call was charged in USD, as a decimal string, for example 0.000420; the same value as the response's usage.sylphx.price. Output only.
start_time	timestamp	When the gateway received the call. Output only.
end_time	timestamp	When the last byte of the answer was sent. Output only.
time_to_first_chunk	duration	From receipt to the first output chunk; unset when nothing streamed. Output only.
streamed	bool	Whether the answer was streamed. Output only.
data_policy	string	The data policy the call ran under: standard, zdr or training. Output only.
tags	map<string, string>	The caller's tags (Sylphx-Tags and the request's metadata), at most 64; filter as tags.<key> = "value". Output only.
end_user	string	The caller's own end-user id (user or safety_identifier), as sent. Output only.

#Methods

Every method of the collection, in the registry's order, with the scope it needs. The full request, response and examples are one link away.

Method	Call	What it does
GET	get	Gets a generation: one Sylphx AI call.
GET	list	Lists the environment's Sylphx AI calls, newest first, within the trace retention; filter by request_model, outcome, api_key, start_time, tags.<key> and the other filterable fields.

#get

Gets a generation: one Sylphx AI call.

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/generations/generation · scope observability:read · effect read · Request, response and examples

#list

Lists the environment's Sylphx AI calls, newest first, within the trace retention; filter by request_model, outcome, api_key, start_time, tags.<key> and the other filterable fields.

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/generations · scope observability:read · effect read · paginated · Request, response and examples