# `LlmCall.Media.Codec`
[🔗](https://github.com/gilbertwong96/llm_call/blob/main/lib/llm_call/media/codec.ex#L1)

The behaviour every media generation adapter implements.

A synchronous codec implements everything except `decode_operation/2`. An
asynchronous codec also implements `decode_operation/2` and declares
`async: true` in its capabilities.

`encode_submit/2` validates first, like the completion side. `decode_submit/2`
returns either finished assets or an `LlmCall.Operation` whose `next` request
advances the job.

# `capabilities`

```elixir
@callback capabilities(LlmCall.Media.Request.t(), LlmCall.Config.t()) ::
  LlmCall.Media.Capabilities.t()
```

# `decode_error`

```elixir
@callback decode_error(LlmCall.wire_value(), LlmCall.Config.t()) :: LlmCall.Error.t()
```

# `decode_operation`
*optional* 

```elixir
@callback decode_operation(LlmCall.wire_value(), LlmCall.Config.t()) ::
  {:ok, LlmCall.Operation.t()} | {:error, LlmCall.Error.t()}
```

# `decode_submit`

```elixir
@callback decode_submit(LlmCall.wire_value(), LlmCall.Config.t()) ::
  {:ok, LlmCall.Media.Response.t()} | {:error, LlmCall.Error.t()}
```

# `encode_submit`

```elixir
@callback encode_submit(LlmCall.Media.Request.t(), LlmCall.Config.t()) ::
  {:ok, LlmCall.EncodedRequest.t()} | {:error, LlmCall.Error.t()}
```

# `info`

```elixir
@callback info() :: LlmCall.Codec.Info.t()
```

# `validate_request`

```elixir
@callback validate_request(LlmCall.Media.Request.t(), LlmCall.Config.t()) ::
  :ok | {:error, LlmCall.Error.t()}
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*
