Claude Platform Docs

Créer un rêve

$client->beta->dreams->create(list<BetaDreamInput> inputs, Model model, ?string instructions, ?BetaOutputBehavior outputBehavior, ?list<AnthropicBeta> betas, ?string workspaceID): BetaDream
POST/v1/dreams
Requires anthropic-beta: dreaming-2026-04-21. How to send beta headers

Démarrez une tâche asynchrone qui utilise des sessions passées pour produire une version réorganisée d'un magasin de mémoire, et récupérez le rêve à interroger pour obtenir le résultat.

Par défaut, le rêve écrit son résultat dans un nouveau magasin de mémoire et ne modifie pas le magasin de mémoire d'entrée. La réponse a status défini sur pending et un tableau outputs vide. Interrogez le rêve jusqu'à ce que status soit completed, failed ou canceled.

Consultez le guide Dreams pour en savoir plus sur la création de rêves.

Parameters
inputs: list<BetaDreamInput>

The memory store and sessions for the dream to read, as exactly one memory_store entry and exactly one sessions entry.

model: Model

The model that runs a dream, given as a model ID or as an object with id and speed.

In the object form, speed can only be standard.

The Availability section of the Dreams guide lists the supported models.

instructions?: optional string

Guidance that steers how the dream reads the sessions and organizes the output memory store, from 1 to 4,096 characters.

See the Dreams guide for what kinds of instructions work well.

outputBehavior?: optional BetaOutputBehavior

Which memory store a dream writes its result to. Defaults to create_new when left out of a create request.

betas?: optional list<AnthropicBeta>⁠Header parameter

This endpoint is in beta: requests must send dreaming-2026-04-21 in this header.

workspaceID?: optional string⁠Header parameter

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns
class BetaDream { $type = 'dream'; $id; $archivedAt; /* 11 more */ }
Créer un rêve
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;
use Anthropic\Beta\AnthropicBeta;

$client = new Client(apiKey: 'my-anthropic-api-key');

$betaDream = $client->beta->dreams->create(
  inputs: [['memoryStoreID' => 'x', 'type' => 'memory_store']],
  model: 'string',
  instructions: 'x',
  outputBehavior: ['type' => 'create_new'],
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
  workspaceID: 'wrkspc_011CZkZaBF1tNoB5wlCeusgy',
);

var_dump($betaDream);
Returns Examples
Response 200
{
  "id": "id",
  "archived_at": "2019-12-27T18:11:19.117Z",
  "created_at": "2019-12-27T18:11:19.117Z",
  "ended_at": "2019-12-27T18:11:19.117Z",
  "error": {
    "message": "message",
    "type": "type"
  },
  "inputs": [
    {
      "memory_store_id": "x",
      "type": "memory_store"
    }
  ],
  "instructions": "instructions",
  "model": {
    "id": "x",
    "speed": "standard"
  },
  "output_behavior": {
    "type": "create_new"
  },
  "outputs": [
    {
      "memory_store_id": "memory_store_id",
      "type": "memory_store"
    }
  ],
  "session_id": "session_id",
  "status": "pending",
  "type": "dream",
  "usage": {
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "input_tokens": 0,
    "output_tokens": 0
  }
}