G

AIP-18 — Model Interface Standard

AIP-18 — Model Interface Standard

Abstract#

Defines the vendor-neutral inference interface contract required for any model used within Gao AI OS.

This standard ensures:

  • pluggability

  • vendor neutrality

  • deterministic integration

  • policy enforcement compatibility

Design Principle#

Gao AI OS is model-agnostic.

Models MUST comply with runtime interface constraints.

Inference Interface Contract#

All compliant models MUST expose the following inputs.

Required Inputs

{
  "prompt": "string",
  "max_tokens": "number",
  "temperature": "number",
  "top_p": "number",
  "stop": ["string"],
  "structured_output_schema": "optional"
}

Required Outputs

{
  "text": "string",
  "finish_reason": "stop|max_tokens|error",
  "usage": {
    "prompt_tokens": "number",
    "completion_tokens": "number"
  }
}

Structured Output Mode#

If structured_output_schema is present, the model MUST:

  • produce JSON-valid output

  • respect schema

  • not inject extraneous keys

Determinism Mode#

Runtime MAY request deterministic inference.

{
  "deterministic": true
}

Models SHOULD:

  • minimize sampling variance

  • support reproducible inference

Security Requirements#

Models MUST NOT:

  • execute external code

  • initiate network calls

  • bypass runtime

All external interaction MUST go through GAR Tool Router.

Compatibility Declaration#

Each model pack MUST declare:

{
  "schema": "gao.model.pack.v1",
  "model_class": "M-16.2",
  "max_context": 8192,
  "supports_structured_output": true,
  "supports_determinism": true
}

Compliance Note#

This AIP does not mandate:

  • vendor

  • license

  • architecture

It defines only interface behavior.