java/resources/models/methods/retrieve/index.md 2026-07-10 23:02 UTC to 2026-07-12 06:58 UTC

Retrieve model

Model models().retrieve(ModelRetrieveParamsparams = ModelRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

get /models/{model}

Retrieves a model instance, providing basic information about the model such as the owner and permissioning.

Parameters

• ModelRetrieveParams params

  • Optional<String> model

Returns

• class Model:

  Describes an OpenAI model offering that can be used with the API.

  • String id

    The model identifier, which can be referenced in the API endpoints.

  • long created

    The Unix timestamp (in seconds) when the model was created.

  • JsonValue; object_ "model"constant

    The object type, which is always "model".

    • MODEL("model")

  • String ownedBy

    The organization that owns the model.

Example

package com.openai.example;

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.models.Model;
import com.openai.models.models.ModelRetrieveParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        OpenAIClient client = OpenAIOkHttpClient.fromEnv();

        Model model = client.models().retrieve("gpt-4o-mini");
    }
}

Response

{
  "id": "id",
  "created": 0,
  "object": "model",
  "owned_by": "owned_by"
}