antfly-sdk 0.0.2.dev2__py3-none-any.whl

antfly/client_generated/api/default/create_embedding.py

@@ -0,0 +1,204 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.inference_embed_request import InferenceEmbedRequest
+from ...models.inference_embed_response import InferenceEmbedResponse
+from ...models.inference_error import InferenceError
+from ...types import Response
+
+
+def _get_kwargs(
+    *,
+    body: InferenceEmbedRequest,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/ai/v1/embeddings",
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> InferenceEmbedResponse | InferenceError | None:
+    if response.status_code == 200:
+        response_200 = InferenceEmbedResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 400:
+        response_400 = InferenceError.from_dict(response.json())
+
+        return response_400
+
+    if response.status_code == 404:
+        response_404 = InferenceError.from_dict(response.json())
+
+        return response_404
+
+    if response.status_code == 500:
+        response_500 = InferenceError.from_dict(response.json())
+
+        return response_500
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[InferenceEmbedResponse | InferenceError]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    body: InferenceEmbedRequest,
+) -> Response[InferenceEmbedResponse | InferenceError]:
+    """Create embeddings (OpenAI-compatible)
+
+     OpenAI-compatible embeddings endpoint. Accepts the same request format
+    as OpenAI's `/v1/embeddings` API, served here under `/ai/v1/embeddings`.
+    For sparse-capable models, each `data` item still uses the `embedding`
+    field, but its value is a sparse vector object instead of a dense float array.
+    Use this endpoint for drop-in compatibility with OpenAI SDKs.
+
+    Args:
+        body (InferenceEmbedRequest): OpenAI-compatible embedding request with inference
+            multimodal content-part extension
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[InferenceEmbedResponse | InferenceError]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+    body: InferenceEmbedRequest,
+) -> InferenceEmbedResponse | InferenceError | None:
+    """Create embeddings (OpenAI-compatible)
+
+     OpenAI-compatible embeddings endpoint. Accepts the same request format
+    as OpenAI's `/v1/embeddings` API, served here under `/ai/v1/embeddings`.
+    For sparse-capable models, each `data` item still uses the `embedding`
+    field, but its value is a sparse vector object instead of a dense float array.
+    Use this endpoint for drop-in compatibility with OpenAI SDKs.
+
+    Args:
+        body (InferenceEmbedRequest): OpenAI-compatible embedding request with inference
+            multimodal content-part extension
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        InferenceEmbedResponse | InferenceError
+    """
+
+    return sync_detailed(
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    body: InferenceEmbedRequest,
+) -> Response[InferenceEmbedResponse | InferenceError]:
+    """Create embeddings (OpenAI-compatible)
+
+     OpenAI-compatible embeddings endpoint. Accepts the same request format
+    as OpenAI's `/v1/embeddings` API, served here under `/ai/v1/embeddings`.
+    For sparse-capable models, each `data` item still uses the `embedding`
+    field, but its value is a sparse vector object instead of a dense float array.
+    Use this endpoint for drop-in compatibility with OpenAI SDKs.
+
+    Args:
+        body (InferenceEmbedRequest): OpenAI-compatible embedding request with inference
+            multimodal content-part extension
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[InferenceEmbedResponse | InferenceError]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+    body: InferenceEmbedRequest,
+) -> InferenceEmbedResponse | InferenceError | None:
+    """Create embeddings (OpenAI-compatible)
+
+     OpenAI-compatible embeddings endpoint. Accepts the same request format
+    as OpenAI's `/v1/embeddings` API, served here under `/ai/v1/embeddings`.
+    For sparse-capable models, each `data` item still uses the `embedding`
+    field, but its value is a sparse vector object instead of a dense float array.
+    Use this endpoint for drop-in compatibility with OpenAI SDKs.
+
+    Args:
+        body (InferenceEmbedRequest): OpenAI-compatible embedding request with inference
+            multimodal content-part extension
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        InferenceEmbedResponse | InferenceError
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            body=body,
+        )
+    ).parsed

antfly/client_generated/api/default/extract.py

@@ -0,0 +1,201 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.extraction_request import ExtractionRequest
+from ...models.extraction_response import ExtractionResponse
+from ...models.inference_error import InferenceError
+from ...types import Response
+
+
+def _get_kwargs(
+    *,
+    body: ExtractionRequest,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/ai/v1/extract",
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> ExtractionResponse | InferenceError | None:
+    if response.status_code == 200:
+        response_200 = ExtractionResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 400:
+        response_400 = InferenceError.from_dict(response.json())
+
+        return response_400
+
+    if response.status_code == 404:
+        response_404 = InferenceError.from_dict(response.json())
+
+        return response_404
+
+    if response.status_code == 500:
+        response_500 = InferenceError.from_dict(response.json())
+
+        return response_500
+
+    if response.status_code == 503:
+        response_503 = InferenceError.from_dict(response.json())
+
+        return response_503
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[ExtractionResponse | InferenceError]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    body: ExtractionRequest,
+) -> Response[ExtractionResponse | InferenceError]:
+    """Extract entities, relations, classifications, and structures
+
+     Schema-driven extraction over shared AI content parts. This is the
+    canonical public API for named entity recognition, relation extraction,
+    text/document classification, token classification, and structured
+    document extraction.
+
+    Args:
+        body (ExtractionRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[ExtractionResponse | InferenceError]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+    body: ExtractionRequest,
+) -> ExtractionResponse | InferenceError | None:
+    """Extract entities, relations, classifications, and structures
+
+     Schema-driven extraction over shared AI content parts. This is the
+    canonical public API for named entity recognition, relation extraction,
+    text/document classification, token classification, and structured
+    document extraction.
+
+    Args:
+        body (ExtractionRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        ExtractionResponse | InferenceError
+    """
+
+    return sync_detailed(
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    body: ExtractionRequest,
+) -> Response[ExtractionResponse | InferenceError]:
+    """Extract entities, relations, classifications, and structures
+
+     Schema-driven extraction over shared AI content parts. This is the
+    canonical public API for named entity recognition, relation extraction,
+    text/document classification, token classification, and structured
+    document extraction.
+
+    Args:
+        body (ExtractionRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[ExtractionResponse | InferenceError]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+    body: ExtractionRequest,
+) -> ExtractionResponse | InferenceError | None:
+    """Extract entities, relations, classifications, and structures
+
+     Schema-driven extraction over shared AI content parts. This is the
+    canonical public API for named entity recognition, relation extraction,
+    text/document classification, token classification, and structured
+    document extraction.
+
+    Args:
+        body (ExtractionRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        ExtractionResponse | InferenceError
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            body=body,
+        )
+    ).parsed

antfly/client_generated/api/default/generate_content.py

@@ -0,0 +1,257 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.inference_error import InferenceError
+from ...models.inference_generate_request import InferenceGenerateRequest
+from ...models.inference_generate_response import InferenceGenerateResponse
+from ...types import Response
+
+
+def _get_kwargs(
+    *,
+    body: InferenceGenerateRequest,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/ai/v1/generate",
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> InferenceError | InferenceGenerateResponse | None:
+    if response.status_code == 200:
+        response_200 = InferenceGenerateResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 400:
+        response_400 = InferenceError.from_dict(response.json())
+
+        return response_400
+
+    if response.status_code == 404:
+        response_404 = InferenceError.from_dict(response.json())
+
+        return response_404
+
+    if response.status_code == 500:
+        response_500 = InferenceError.from_dict(response.json())
+
+        return response_500
+
+    if response.status_code == 503:
+        response_503 = InferenceError.from_dict(response.json())
+
+        return response_503
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[InferenceError | InferenceGenerateResponse]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    body: InferenceGenerateRequest,
+) -> Response[InferenceError | InferenceGenerateResponse]:
+    """Generate text using LLM (OpenAI-compatible)
+
+     Generates text using local LLM models (e.g., Gemma 3).
+    Fully compatible with the OpenAI Chat Completions API.
+
+    ## Models
+
+    Models are auto-discovered from `models_dir/generators/` at startup.
+    Use the `/ai/v1/models` endpoint to list available models.
+
+    ## Streaming
+
+    Set `stream: true` to receive Server-Sent Events (SSE) with incremental
+    token deltas. Each event contains a `ChatCompletionChunk` object.
+    The stream ends with `data: [DONE]`.
+
+    ## Input Format
+
+    Uses OpenAI-compatible chat format with messages array containing role
+    (system, user, assistant) and content. Set `stream: true` for streaming responses.
+
+    Args:
+        body (InferenceGenerateRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[InferenceError | InferenceGenerateResponse]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+    body: InferenceGenerateRequest,
+) -> InferenceError | InferenceGenerateResponse | None:
+    """Generate text using LLM (OpenAI-compatible)
+
+     Generates text using local LLM models (e.g., Gemma 3).
+    Fully compatible with the OpenAI Chat Completions API.
+
+    ## Models
+
+    Models are auto-discovered from `models_dir/generators/` at startup.
+    Use the `/ai/v1/models` endpoint to list available models.
+
+    ## Streaming
+
+    Set `stream: true` to receive Server-Sent Events (SSE) with incremental
+    token deltas. Each event contains a `ChatCompletionChunk` object.
+    The stream ends with `data: [DONE]`.
+
+    ## Input Format
+
+    Uses OpenAI-compatible chat format with messages array containing role
+    (system, user, assistant) and content. Set `stream: true` for streaming responses.
+
+    Args:
+        body (InferenceGenerateRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        InferenceError | InferenceGenerateResponse
+    """
+
+    return sync_detailed(
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    body: InferenceGenerateRequest,
+) -> Response[InferenceError | InferenceGenerateResponse]:
+    """Generate text using LLM (OpenAI-compatible)
+
+     Generates text using local LLM models (e.g., Gemma 3).
+    Fully compatible with the OpenAI Chat Completions API.
+
+    ## Models
+
+    Models are auto-discovered from `models_dir/generators/` at startup.
+    Use the `/ai/v1/models` endpoint to list available models.
+
+    ## Streaming
+
+    Set `stream: true` to receive Server-Sent Events (SSE) with incremental
+    token deltas. Each event contains a `ChatCompletionChunk` object.
+    The stream ends with `data: [DONE]`.
+
+    ## Input Format
+
+    Uses OpenAI-compatible chat format with messages array containing role
+    (system, user, assistant) and content. Set `stream: true` for streaming responses.
+
+    Args:
+        body (InferenceGenerateRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[InferenceError | InferenceGenerateResponse]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+    body: InferenceGenerateRequest,
+) -> InferenceError | InferenceGenerateResponse | None:
+    """Generate text using LLM (OpenAI-compatible)
+
+     Generates text using local LLM models (e.g., Gemma 3).
+    Fully compatible with the OpenAI Chat Completions API.
+
+    ## Models
+
+    Models are auto-discovered from `models_dir/generators/` at startup.
+    Use the `/ai/v1/models` endpoint to list available models.
+
+    ## Streaming
+
+    Set `stream: true` to receive Server-Sent Events (SSE) with incremental
+    token deltas. Each event contains a `ChatCompletionChunk` object.
+    The stream ends with `data: [DONE]`.
+
+    ## Input Format
+
+    Uses OpenAI-compatible chat format with messages array containing role
+    (system, user, assistant) and content. Set `stream: true` for streaming responses.
+
+    Args:
+        body (InferenceGenerateRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        InferenceError | InferenceGenerateResponse
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            body=body,
+        )
+    ).parsed