Schema

Use this reference to inspect fields, methods, accepted values and failure outcomes. For setup and working examples, start with the API guide.

Definition: abstraction.inference.job

Encoding [DEF-E1]

setting	value	rule
`escape`	`minimal`	[DEF-E2]
`indent`	`2`	[DEF-E3]
`map_keys`	`utf8-bytes`	[DEF-E4]
`numbers`	`integer-decimal`	[DEF-E5]
`opaque`	`verbatim`	[DEF-E6]
`terminator`	`newline`	[DEF-E7]
`duplicate_keys`	`refuse`	[DEF-E8]
`depth_limit`	`64`	[DEF-E9]

Types

kind	types
built in	`Mode` `Profile` `i64` `string`
declared below	`ImageRequest` `JobResult` `Request`
container [DEF-T3]	`list<RequestGuarantee>` `list<string>`
repeated record [DEF-A9]	`list<Delivery>`
string map [DEF-A10]	`map<string,string>`

Structs [DEF-T1]

A field is required, or says when it is omitted [DEF-A4]. Each struct says on its own what it does with a field name it has never heard of [DEF-A7]. A wire name never moves; where a language must spell it differently the field says so [DEF-A2].

`ImageRequest`

unknown fields refuse

id	field	type	presence	named elsewhere
1	`model`	`string`	required	—
2	`mode`	`Mode`	required	—
3	`prompt`	`string`	required	—
4	`size`	`string`	required	—
5	`count`	`i64`	required	—
6	`image_digest`	`string`	optional · omitted when zero	—
7	`image_media_type`	`string`	optional · omitted when zero	—
8	`mask_digest`	`string`	optional · omitted when zero	—
9	`mask_media_type`	`string`	optional · omitted when zero	—
10	`guarantees`	`list<RequestGuarantee>`	required	—
11	`credential`	`string`	optional · omitted when zero	—
12	`required_extensions`	`list<string>`	optional · omitted when zero	—
13	`extensions`	`map<string,string>`	optional · omitted when zero	—

`Delivery`

unknown fields refuse

id	field	type	presence	named elsewhere
1	`digest`	`string`	required	—
2	`media_type`	`string`	required	—
3	`size`	`i64`	required	—
4	`location`	`string`	required	—

`Request`

unknown fields refuse

id	field	type	presence	named elsewhere
1	`profile`	`Profile`	required	—
2	`image`	`ImageRequest`	required	—
3	`duration_ms`	`i64`	optional · omitted when zero	—

`JobResult`

unknown fields refuse

id	field	type	presence	named elsewhere
1	`profile`	`Profile`	required	—
2	`deliveries`	`list<Delivery>`	required	—
3	`host`	`string`	required	—
4	`model`	`string`	required	—

`Document`

the document [DEF-A1] · unknown fields refuse

id	field	type	presence	named elsewhere
1	`request`	`Request`	optional · omitted when absent	—
2	`result`	`JobResult`	optional · omitted when absent	—

Enumerations [DEF-T5]

Enum fields carry JSON strings containing exact member wire spellings, never numeric IDs. Unknown names are preserved with grant and refused as bad_enum with refuse on read and write. Optional absent fields preserve presence separately from an empty string.

An enumeration is a closed vocabulary of wire names, and each one says on its own what a reader does with a member it has never heard of [DEF-A5].

`Profile`

a member this reader does not know is refuse

id	member	wire
1	`video`	`video`
2	`image_batch`	`image_batch`

`Mode`

a member this reader does not know is refuse

id	member	wire
1	`generate`	`generate`
2	`edit`	`edit`

`RequestGuarantee`

a member this reader does not know is grant

id	member	wire
1	`local_only`	`abstraction.inference/local-only@1`
2	`hosted_allowed`	`abstraction.inference/hosted-allowed@1`

Constants [DEF-A6]

name	type	value
`kinds`	`list<string>`	`inference`
`execution_guarantees`	`list<string>`	`abstraction.inference/recoverable-upstream@1`

Refusal words [DEF-R1]

order	word	stage
1	`malformed`	`grammar`
2	`bad_string`	`grammar`
3	`number_spelling`	`grammar`
4	`wrong_type`	`grammar`
5	`depth_exceeded`	`grammar`
6	`duplicate_key`	`grammar`
7	`duplicate_field`	`structure`
8	`unknown_field`	`structure`
9	`missing_field`	`structure`
10	`bad_enum`	`structure`
11	`trailing_bytes`	`document`