RESPONSES API

Responses API

The Responses API is the primary inference interface for Rowe 1.0. Use it for synchronous spatial reasoning requests that return typed model outputs and request-level usage metadata.

POST /api/v1/responses

The Responses API is the main inference endpoint.

POST → https://fourechelon.com/api/v1/responses

Terminal

const response = await fetch("https://fourechelon.com/api/v1/responses", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FOUR_ECHELON_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "rowe-1.0",
    input: {
      task_type: "fit",
      object_id: "case",
      secondary_id: "shelf",
      point_cloud_scene: {
        point_clouds: [
          {
            object_id: "case",
            kind: "box",
            points: [
              { x: 0, y: 0, z: 0 },
              { x: 1, y: 0, z: 0 },
              { x: 0, y: 1, z: 1 },
            ],
          },
        ],
      },
    },
  }),
});

const result = await response.json();