Container-API

Mit der Container-API können Sie sichere, zustandsbehaftete, isolierte Sandboxes zum Ausführen von Code- und Shellbefehlen (z.B. Python) zur Verarbeitung von Daten verwenden.

Diese API unterstützt mehrstufige, rechenintensive Workflows wie Analysen, Dateiuploads und -downloads sowie das Generieren von Artefakten. So können Agents Code ausführen und programmgesteuerte Logik anwenden, um komplexe Aufgaben auszuführen.

Hinweis

Die OCI-Container-API verwendet dasselbe Format wie die OpenAI-Dateien-API mit dem OCI OpenAI-kompatiblen Endpunkt. Syntax- und Anforderungsdetails finden Sie in der OpenAI Containers API-Dokumentation. Die nicht unterstützten Eigenschaften finden Sie in den Abschnitten OCI-Einschränkungen auf dieser Seite.

Unterstützter API-Endpunkt

Basis-URL Endpunktpfad Authentifizierung
https://inference.generativeai.${region}.oci.oraclecloud.com/openai/v1 /containers API-Schlüssel oder IAM-Session

Ersetzen Sie ${region} durch eine unterstützte Region, wie us-chicago-1.

Obwohl das Anforderungsformat OpenAI-kompatibel ist, verwendet die Authentifizierung OCI-Zugangsdaten, Anforderungen werden über OCI Generative AI-Inferenzendpunkte weitergeleitet, und Ressourcen und Ausführung bleiben in OCI.

Tipp

Die Schritte, die vor der Verwendung dieser API ausgeführt werden müssen, finden Sie unter QuickStart.

Authentifizierung

Sie können auf zwei Arten auf OCI OpenAI-kompatible Endpunkte zugreifen:

Verwenden Sie API-Schlüssel für Tests und frühe Entwicklung. Verwenden Sie die IAM-basierte Authentifizierung für Produktions-Workloads und OCI-verwaltete Umgebungen.

Container erstellen

POST /containers

Referenz

Container erstellen

Beispiel:

# create container
container = client.containers.create(
    name="name",
)
print(container.id)
OCI-Einschränkungen
Hinweis

Skills und Netzwerkrichtlinien werden nicht unterstützt.

Container auflisten

GET /containers

Referenz

Container auflisten

Beispiel:

# list containers
page = client.containers.list()
page = page.data[0]
print(page.id)
OCI-Einschränkungen
Keine

Containerinformationen werden abgerufen...

GET /containers/{container_id}

Referenz

Container abrufen

Beispiel:

# retrieve container
container = client.containers.retrieve(
    "container_id",
)
print(container.id)
OCI-Einschränkungen
Keine

Container entfernen

DELETE /containers/{container_id}

Referenz

Container löschen

Beispiel:

# delete container
client.containers.delete(
    "container_id",
)
OCI-Einschränkungen
Keine