// File generated from our OpenAPI spec by Stainless.

package com.openai.models.images

import com.fasterxml.jackson.annotation.JsonCreator
import com.openai.core.Enum
import com.openai.core.JsonField
import com.openai.errors.OpenAIInvalidDataException

class ImageModel @JsonCreator private constructor(private val value: JsonField<String>) : Enum {

    /**
     * Returns this class instance's raw value.
     *
     * This is usually only useful if this instance was deserialized from data that doesn't match
     * any known member, and you want to know that value. For example, if the SDK is on an older
     * version than the API, then the API may respond with new members that the SDK is unaware of.
     */
    @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value

    companion object {

        @JvmField val GPT_IMAGE_1 = of("gpt-image-1")

        @JvmField val GPT_IMAGE_1_MINI = of("gpt-image-1-mini")

        @JvmField val GPT_IMAGE_2 = of("gpt-image-2")

        @JvmField val GPT_IMAGE_2_2026_04_21 = of("gpt-image-2-2026-04-21")

        @JvmField val GPT_IMAGE_1_5 = of("gpt-image-1.5")

        @JvmField val CHATGPT_IMAGE_LATEST = of("chatgpt-image-latest")

        @JvmField val DALL_E_2 = of("dall-e-2")

        @JvmField val DALL_E_3 = of("dall-e-3")

        @JvmStatic fun of(value: String) = ImageModel(JsonField.of(value))
    }

    /** An enum containing [ImageModel]'s known values. */
    enum class Known {
        GPT_IMAGE_1,
        GPT_IMAGE_1_MINI,
        GPT_IMAGE_2,
        GPT_IMAGE_2_2026_04_21,
        GPT_IMAGE_1_5,
        CHATGPT_IMAGE_LATEST,
        DALL_E_2,
        DALL_E_3,
    }

    /**
     * An enum containing [ImageModel]'s known values, as well as an [_UNKNOWN] member.
     *
     * An instance of [ImageModel] can contain an unknown value in a couple of cases:
     * - It was deserialized from data that doesn't match any known member. For example, if the SDK
     *   is on an older version than the API, then the API may respond with new members that the SDK
     *   is unaware of.
     * - It was constructed with an arbitrary value using the [of] method.
     */
    enum class Value {
        GPT_IMAGE_1,
        GPT_IMAGE_1_MINI,
        GPT_IMAGE_2,
        GPT_IMAGE_2_2026_04_21,
        GPT_IMAGE_1_5,
        CHATGPT_IMAGE_LATEST,
        DALL_E_2,
        DALL_E_3,
        /** An enum member indicating that [ImageModel] was instantiated with an unknown value. */
        _UNKNOWN,
    }

    /**
     * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN] if
     * the class was instantiated with an unknown value.
     *
     * Use the [known] method instead if you're certain the value is always known or if you want to
     * throw for the unknown case.
     */
    fun value(): Value =
        when (this) {
            GPT_IMAGE_1 -> Value.GPT_IMAGE_1
            GPT_IMAGE_1_MINI -> Value.GPT_IMAGE_1_MINI
            GPT_IMAGE_2 -> Value.GPT_IMAGE_2
            GPT_IMAGE_2_2026_04_21 -> Value.GPT_IMAGE_2_2026_04_21
            GPT_IMAGE_1_5 -> Value.GPT_IMAGE_1_5
            CHATGPT_IMAGE_LATEST -> Value.CHATGPT_IMAGE_LATEST
            DALL_E_2 -> Value.DALL_E_2
            DALL_E_3 -> Value.DALL_E_3
            else -> Value._UNKNOWN
        }

    /**
     * Returns an enum member corresponding to this class instance's value.
     *
     * Use the [value] method instead if you're uncertain the value is always known and don't want
     * to throw for the unknown case.
     *
     * @throws OpenAIInvalidDataException if this class instance's value is a not a known member.
     */
    fun known(): Known =
        when (this) {
            GPT_IMAGE_1 -> Known.GPT_IMAGE_1
            GPT_IMAGE_1_MINI -> Known.GPT_IMAGE_1_MINI
            GPT_IMAGE_2 -> Known.GPT_IMAGE_2
            GPT_IMAGE_2_2026_04_21 -> Known.GPT_IMAGE_2_2026_04_21
            GPT_IMAGE_1_5 -> Known.GPT_IMAGE_1_5
            CHATGPT_IMAGE_LATEST -> Known.CHATGPT_IMAGE_LATEST
            DALL_E_2 -> Known.DALL_E_2
            DALL_E_3 -> Known.DALL_E_3
            else -> throw OpenAIInvalidDataException("Unknown ImageModel: $value")
        }

    /**
     * Returns this class instance's primitive wire representation.
     *
     * This differs from the [toString] method because that method is primarily for debugging and
     * generally doesn't throw.
     *
     * @throws OpenAIInvalidDataException if this class instance's value does not have the expected
     *   primitive type.
     */
    fun asString(): String =
        _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }

    private var validated: Boolean = false

    /**
     * Validates that the types of all values in this object match their expected types recursively.
     *
     * This method is _not_ forwards compatible with new types from the API for existing fields.
     *
     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
     *   expected type.
     */
    fun validate(): ImageModel = apply {
        if (validated) {
            return@apply
        }

        known()
        validated = true
    }

    fun isValid(): Boolean =
        try {
            validate()
            true
        } catch (e: OpenAIInvalidDataException) {
            false
        }

    /**
     * Returns a score indicating how many valid values are contained in this object recursively.
     *
     * Used for best match union deserialization.
     */
    @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1

    override fun equals(other: Any?): Boolean {
        if (this === other) {
            return true
        }

        return other is ImageModel && value == other.value
    }

    override fun hashCode() = value.hashCode()

    override fun toString() = value.toString()
}
