# Computer use (computer_use_preview, computer) and the computer-use-preview model

Status: computer_use_preview DOCUMENTED · PREVIEW · ACCOUNT_RESTRICTED (2026-09-18: POST /v1/responses with model: computer-use-preview → HTTP 404 model_not_found "does not exist or you do not have access") · computer DOCUMENTED · UNVERIFIED Sources: https://developers.openai.com/api/docs/guides/tools-computer-use · https://developers.openai.com/api/docs/guides/tools-computer-use-integration · https://developers.openai.com/api/docs/models/computer-use-preview · openapi-master.yaml ComputerUsePreviewTool, ComputerTool, ComputerToolCall, ComputerToolCallOutput, ToolChoiceTypes Last verified: 2026-09-18

# Two integration styles (docs)

1. Code execution (recommended for GPT-6 Astra): a function tool that accepts a script (PyAutoGUI/Playwright) run in your isolated environment; returns text + screenshots (detail: "original" to preserve pixels).
2. The computer tool: model returns structured actions; you execute them and send back a screenshot.

# Tool definitions

tool_choice hosted forms: {"type":"computer"}, {"type":"computer_use_preview"}, {"type":"computer_use"} (spec enum).

# Loop items

• Output computer_call {id, call_id, action, actions[] (batched, computer_use), pending_safety_checks[] {id, code, message}, status}. action.type ∈ click {button: left|right|wheel|back|forward, x, y, keys?}, double_click {x,y,keys}, drag {path[{x,y}], keys?}, keypress {keys[]}, move {x,y}, screenshot, scroll {x,y,scroll_x,scroll_y}, type {text}, wait.
• Input computer_call_output {call_id, output: {type:"computer_screenshot", image_url | file_id}, acknowledged_safety_checks[]}; continue with previous_response_id until no more computer_call.
• include: ["computer_call_output.output.image_url"] returns screenshot URLs when listing items.

# Safety (docs, mandatory)

Isolated browser/VM + site allow-list · treat screen text as untrusted (cannot grant permission) · confirm at the point of risk and require explicit consent before transmitting sensitive data · stop/escalate on suspected prompt injection · bound steps/time/cost, support cancellation, verify outcomes · acknowledge pending_safety_checks deliberately.

# Live evidence

Examples: examples/openai/tools/computer-use/ (sh/py/ts reproduce the 404). Migration notes: docs section "Migration from computer-use-preview" in the integration guide.