Official SDKs for five languages

import uuid

from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment

model = client.get_model("MODEL_ID_FROM_CATALOG")
quote = client.quote_task(
    model=model["model"],
    input_data={"prompt": "A cinematic night portrait"},
)
print(quote["estimatedCost"], quote["maxCharge"])  # decide before you spend

task = client.create_task(
    model=model["model"],
    input_data={"prompt": "A cinematic night portrait"},
    idempotency_key=str(uuid.uuid4()),
    quote_id=quote["quoteId"],
    expected_cost=quote["estimatedCost"],
)
final = client.wait_for_terminal(task["taskId"])
for asset in output_assets(final):
    print(asset["url"])

client, err := spicy.New(spicy.Options{}) // reads SPICY_API_KEY from the environment
if err != nil {
	return err
}

request := spicy.CreateTaskInput{
	Model: "MODEL_ID_FROM_CATALOG",
	Input: map[string]any{"prompt": "A cinematic night portrait"},
}

quote, err := client.Quote(ctx, request)
if err != nil {
	return err
}
request.QuoteID = quote.QuoteID
request.ExpectedCost = quote.EstimatedCost

// Store this next to your own record of the job before sending it: its whole
// purpose is to still be there after the crash that lost the response.
key, err := spicy.NewIdempotencyKey()
if err != nil {
	return err
}

task, err := client.CreateTask(ctx, request, key, spicy.CreateTaskOptions{})
if err != nil {
	return err
}

final, err := client.WaitForTerminal(ctx, task.TaskID, spicy.WaitOptions{})
if err != nil {
	return err
}
for _, asset := range final.ReadyAssets() {
	log.Println(asset.URL)
}

use SpicyApi\SpicyClient;

$client = new SpicyClient();  // reads SPICY_API_KEY from the environment

$quote = $client->quote('MODEL_ID_FROM_CATALOG', ['prompt' => 'A cinematic night portrait']);
printf("at most %s\n", $quote['maxCharge']);  // decide before you spend

$task = $client->createTask(
    model: $quote['model'],
    input: ['prompt' => 'A cinematic night portrait'],
    idempotencyKey: SpicyClient::idempotencyKey(),
    quoteId: $quote['quoteId'],
    expectedCost: $quote['estimatedCost'],
);

$final = $client->waitForTerminal($task['taskId']);
foreach (SpicyClient::readyAssets($final) as $asset) {
    echo $asset['url'], "\n";
}

SpicyClient client = SpicyClient.builder().apiKeyFromEnvironment().build();

CreateTaskRequest request = CreateTaskRequest.of(
        "MODEL_ID_FROM_CATALOG",
        Map.of("prompt", "A cinematic night portrait"));

TaskQuote quote = client.quote(request);            // free; reserves nothing
System.out.println("this will cost at most " + quote.maxCharge());

TaskRecord task = client.run(                       // createTask + waitForTerminal
        request.withQuote(quote), UUID.randomUUID().toString());

// Transcription and similar endpoints answer in text and return no files at all.
task.outputText().ifPresent(System.out::println);
for (TaskAsset asset : task.assets()) {
    asset.url().ifPresent(System.out::println);
}